openclaw agents

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

Gerelateerd:

• Routering met meerdere agents
• Agentwerkruimte
• Skills-configuratie: configuratie voor zichtbaarheid van Skills.

Voorbeelden

openclaw agents listopenclaw agents list --bindingsopenclaw agents add work --workspace ~/.openclaw/workspace-workopenclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:*openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactiveopenclaw agents bindingsopenclaw agents bind --agent work --bind telegram:opsopenclaw agents unbind --agent work --bind telegram:opsopenclaw agents set-identity --workspace ~/.openclaw/workspace --from-identityopenclaw agents set-identity --agent main --avatar avatars/openclaw.pngopenclaw agents delete work

Routeringsbindingen

Gebruik routeringsbindingen om inkomend kanaalverkeer vast te zetten op een specifieke agent.

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

Bindingen weergeven:

openclaw agents bindingsopenclaw agents bindings --agent workopenclaw agents bindings --json

Bindingen toevoegen:

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

Je kunt ook bindingen toevoegen wanneer je een agent maakt:

openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:*

Als je accountId (--bind <channel>) weglaat, leidt OpenClaw die af uit Plugin-installatiehooks, geforceerde accountbinding of het geconfigureerde aantal accounts van het kanaal.

Als je --agent weglaat voor bind of unbind, gebruikt OpenClaw de huidige standaardagent als doel.

--bind-indeling

Gedrag van bindingsbereik

• Een opgeslagen binding zonder accountId koppelt alleen 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 afgeleide accountId, werkt OpenClaw die bestaande binding ter plekke bij in plaats van een duplicaat toe te voegen.

Voorbeelden:

# match all accounts on the channelopenclaw agents bind --agent work --bind telegram:* # match a specific accountopenclaw agents bind --agent work --bind telegram:ops # initial channel-only bindingopenclaw agents bind --agent work --bind telegram # later upgrade to account-scoped bindingopenclaw agents bind --agent work --bind telegram:alerts

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

Bindingen verwijderen:

openclaw agents unbind --agent work --bind telegram:opsopenclaw agents unbind --agent work --all

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

Command surface

agents

openclaw agents uitvoeren zonder subopdracht is gelijk aan openclaw agents list.

agents list

Opties:

• --json
• --bindings: neem volledige routeringsregels op, 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-vlaggen 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 nieuwe agent-id.
• In interactieve modus kopieert het seeden van authenticatie alleen overdraagbare statische profielen (standaard api_key en statische token). OAuth-profielen met refresh-token blijven alleen beschikbaar via read-through-overerving uit de echte main-agentopslag. 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 definitief verwijderd.
• Wanneer de Gateway bereikbaar is, wordt verwijdering via de Gateway verzonden, zodat config- en sessieopslagopschoning 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, wordt de werkruimte behouden en rapporteert --json workspaceRetained, workspaceRetainedReason en workspaceSharedWith.

Identiteitsbestanden

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

• Voorbeeldpad: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity leest uit de hoofdmap van de werkruimte (of uit een expliciet --identity-file)

Avatarpaden worden relatief ten opzichte van de hoofdmap 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.
• Lokale, werkruimte-relatieve avatarafbeeldingsbestanden zijn beperkt tot 2 MB. HTTP(S)-URL's en data:-URI's worden niet gecontroleerd met de lokale bestandsgroottelimiet.
• Wanneer er geen expliciete identiteitsvelden zijn opgegeven, leest de opdracht identiteitsgegevens uit IDENTITY.md.

Laden uit IDENTITY.md:

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

Velden expliciet overschrijven:

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

Configuratievoorbeeld:

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

Gerelateerd

• CLI-referentie
• Routering met meerdere agents
• Agentwerkruimte