OmeniaClaw agents

Beheer geïsoleerde agents (werkruimten + auth + routering).

Gerelateerd:

• Multi-agentroutering
• Agentwerkruimte
• Skills-configuratie: configuratie voor zichtbaarheid van Skills.

Voorbeelden

OmeniaClaw agents listOmeniaClaw agents list --bindingsOmeniaClaw agents add work --workspace ~/.OmeniaClaw/workspace-workOmeniaClaw agents add ops --workspace ~/.OmeniaClaw/workspace-ops --bind telegram:ops --non-interactiveOmeniaClaw agents bindingsOmeniaClaw agents bind --agent work --bind telegram:opsOmeniaClaw agents unbind --agent work --bind telegram:opsOmeniaClaw agents set-identity --workspace ~/.OmeniaClaw/workspace --from-identityOmeniaClaw agents set-identity --agent main --avatar avatars/OmeniaClaw.pngOmeniaClaw agents delete work

Routeringsbindings

Gebruik routeringsbindings om inkomend kanaalverkeer aan een specifieke agent vast te pinnen.

Als je ook verschillende zichtbare Skills per agent wilt, configureer dan agents.defaults.skills en agents.list[].skills in OmeniaClaw.json. Zie Skills-configuratie en Configuratiereferentie.

Bindings weergeven:

OmeniaClaw agents bindingsOmeniaClaw agents bindings --agent workOmeniaClaw agents bindings --json

Bindings toevoegen:

OmeniaClaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

Als je accountId weglaat (--bind <channel>), lost OmeniaClaw dit op vanuit kanaalstandaardwaarden en Plugin-installatiehooks wanneer die beschikbaar zijn.

Als je --agent weglaat voor bind of unbind, richt OmeniaClaw zich op de huidige standaardagent.

Gedrag van bindingsbereik

• Een binding zonder accountId komt alleen overeen met het standaardaccount van het kanaal.
• accountId: "*" is de kanaalbrede fallback (alle accounts) en is minder specifiek dan een expliciete accountbinding.
• Als dezelfde agent al een overeenkomende kanaalbinding zonder accountId heeft, en je later bindt met een expliciete of opgeloste accountId, werkt OmeniaClaw die bestaande binding ter plekke bij in plaats van een duplicaat toe te voegen.

Voorbeeld:

# initial channel-only bindingOmeniaClaw agents bind --agent work --bind telegram # later upgrade to account-scoped bindingOmeniaClaw agents bind --agent work --bind telegram:ops

Na de upgrade is routering voor die binding beperkt tot telegram:ops. Als je ook routering voor het standaardaccount wilt, voeg die dan expliciet toe (bijvoorbeeld --bind telegram:default).

Bindings verwijderen:

OmeniaClaw agents unbind --agent work --bind telegram:opsOmeniaClaw agents unbind --agent work --all

unbind accepteert ofwel --all of een of meer --bind-waarden, niet beide.

Commandosurface

agents

Het uitvoeren van OmeniaClaw agents zonder subcommando is gelijk aan OmeniaClaw agents list.

agents list

Opties:

• --json
• --bindings: volledige routeringsregels opnemen, niet alleen aantallen/samenvattingen per agent

agents add [name]

Opties:

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (herhaalbaar)
• --non-interactive
• --json

Opmerkingen:

• Het doorgeven van expliciete add-flags schakelt de opdracht over naar het niet-interactieve pad.
• Niet-interactieve modus vereist zowel een agentnaam als --workspace.
• main is gereserveerd en kan niet worden gebruikt als de nieuwe agent-id.
• In interactieve modus kopieert auth-seeding alleen draagbare statische profielen (api_key en standaard statische token). OAuth-profielen met vernieuwingstokens blijven alleen beschikbaar via read-through-overerving vanuit de echte main-agentstore. Als de geconfigureerde standaardagent niet main is, meld je dan apart aan voor OAuth- profielen op de nieuwe agent.

agents bindings

Opties:

• --agent <id>
• --json

agents bind

Opties:

• --agent <id> (standaard de huidige standaardagent)
• --bind <channel[:accountId]> (herhaalbaar)
• --json

agents unbind

Opties:

• --agent <id> (standaard de huidige standaardagent)
• --bind <channel[:accountId]> (herhaalbaar)
• --all
• --json

agents delete <id>

Opties:

• --force
• --json

Opmerkingen:

• main kan niet worden verwijderd.
• Zonder --force is interactieve bevestiging vereist.
• Werkruimte-, agentstatus- en sessietranscriptmappen worden naar de prullenmand verplaatst, niet hard verwijderd.
• Wanneer de Gateway bereikbaar is, wordt verwijdering via de Gateway verzonden, zodat config- en session-store-opschoning dezelfde writer gebruiken als runtimeverkeer. Als de Gateway niet bereikbaar is, valt de CLI terug op het offline lokale pad.
• Als de werkruimte van een andere agent hetzelfde pad is, binnen deze werkruimte ligt, of deze werkruimte bevat, blijft de werkruimte behouden en rapporteert --json workspaceRetained, workspaceRetainedReason en workspaceSharedWith.

Identiteitsbestanden

Elke agentwerkruimte kan een IDENTITY.md bevatten in de root van de werkruimte:

• Voorbeeldpad: ~/.OmeniaClaw/workspace/IDENTITY.md
• set-identity --from-identity leest vanuit de root van de werkruimte (of een expliciet --identity-file)

Avatarpaden worden relatief aan de root van de werkruimte opgelost.

Identiteit instellen

set-identity schrijft velden naar agents.list[].identity:

• name
• theme
• emoji
• avatar (werkruimte-relatief pad, http(s)-URL of data-URI)

Opties:

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

Opmerkingen:

• --agent of --workspace kan worden gebruikt om de doelagent te selecteren.
• Als je vertrouwt op --workspace en meerdere agents die werkruimte delen, mislukt de opdracht en wordt je gevraagd --agent door te geven.
• Wanneer er geen expliciete identiteitsvelden worden opgegeven, leest de opdracht identiteitsgegevens uit IDENTITY.md.

Laden vanuit IDENTITY.md:

OmeniaClaw agents set-identity --workspace ~/.OmeniaClaw/workspace --from-identity

Velden expliciet overschrijven:

OmeniaClaw agents set-identity --agent main --name "OmeniaClaw" --emoji "🦞" --avatar avatars/OmeniaClaw.png

Config-voorbeeld:

{  agents: {    list: [      {        id: "main",        identity: {          name: "OmeniaClaw",          theme: "space lobster",          emoji: "🦞",          avatar: "avatars/OmeniaClaw.png",        },      },    ],  },}

Gerelateerd

• CLI-referentie
• Multi-agentroutering
• Agentwerkruimte