openclaw agents

Isolierte Agenten verwalten (Workspaces + Authentifizierung + Routing).

Verwandt:

• Multi-Agent-Routing
• Agent-Workspace
• Skills-Konfiguration: Konfiguration der Skill-Sichtbarkeit.

Beispiele

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

Routing-Bindings

Verwenden Sie Routing-Bindings, um eingehenden Channel-Traffic einem bestimmten Agenten fest zuzuordnen.

Wenn Sie außerdem pro Agent unterschiedliche sichtbare Skills verwenden möchten, konfigurieren Sie agents.defaults.skills und agents.list[].skills in openclaw.json. Siehe Skills-Konfiguration und Konfigurationsreferenz.

Bindings auflisten:

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

Bindings hinzufügen:

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

Sie können Bindings auch beim Erstellen eines Agenten hinzufügen:

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

Wenn Sie accountId weglassen (--bind <channel>), löst OpenClaw sie aus Plugin-Setup-Hooks, erzwungenem Account-Binding oder der konfigurierten Account-Anzahl des Channels auf.

Wenn Sie --agent für bind oder unbind weglassen, verwendet OpenClaw den aktuellen Standardagenten als Ziel.

--bind-Format

Verhalten des Binding-Scopes

• Ein gespeichertes Binding ohne accountId entspricht nur dem Standardaccount des Channels.
• accountId: "*" ist der channelweite Fallback (alle Accounts) und ist weniger spezifisch als ein explizites Account-Binding.
• Wenn derselbe Agent bereits ein passendes Channel-Binding ohne accountId hat und Sie später mit einer expliziten oder aufgelösten accountId binden, aktualisiert OpenClaw dieses vorhandene Binding direkt, statt ein Duplikat hinzuzufügen.

Beispiele:

# 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

Nach dem Upgrade ist das Routing für dieses Binding auf telegram:alerts beschränkt. Wenn Sie zusätzlich Routing für den Standardaccount möchten, fügen Sie es explizit hinzu (zum Beispiel --bind telegram:default).

Bindings entfernen:

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

unbind akzeptiert entweder --all oder einen oder mehrere --bind-Werte, nicht beides.

Befehlsoberfläche

agents

Das Ausführen von openclaw agents ohne Unterbefehl entspricht openclaw agents list.

agents list

Optionen:

• --json
• --bindings: vollständige Routing-Regeln einschließen, nicht nur Zählungen/Zusammenfassungen pro Agent

agents add [name]

Optionen:

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

Hinweise:

• Das Übergeben expliziter Add-Flags schaltet den Befehl in den nicht interaktiven Pfad.
• Der nicht interaktive Modus erfordert sowohl einen Agentennamen als auch --workspace.
• main ist reserviert und kann nicht als neue Agenten-ID verwendet werden.
• Im interaktiven Modus kopiert das Auth-Seeding nur portierbare statische Profile (api_key und statisches token standardmäßig). OAuth-Refresh-Token-Profile bleiben nur per Read-through-Vererbung aus dem echten main-Agentenspeicher verfügbar. Wenn der konfigurierte Standardagent nicht main ist, melden Sie sich separat für OAuth- Profile auf dem neuen Agenten an.

agents bindings

Optionen:

• --agent <id>
• --json

agents bind

Optionen:

• --agent <id> (standardmäßig der aktuelle Standardagent)
• --bind <channel[:accountId]> (wiederholbar)
• --json

agents unbind

Optionen:

• --agent <id> (standardmäßig der aktuelle Standardagent)
• --bind <channel[:accountId]> (wiederholbar)
• --all
• --json

agents delete <id>

Optionen:

• --force
• --json

Hinweise:

• main kann nicht gelöscht werden.
• Ohne --force ist eine interaktive Bestätigung erforderlich.
• Workspace-, Agentenstatus- und Sitzungs-Transkriptverzeichnisse werden in den Papierkorb verschoben, nicht endgültig gelöscht.
• Wenn der Gateway erreichbar ist, wird die Löschung über den Gateway gesendet, damit Konfiguration und Bereinigung des Sitzungsspeichers denselben Writer wie Runtime-Traffic verwenden. Wenn der Gateway nicht erreichbar ist, fällt die CLI auf den lokalen Offline-Pfad zurück.
• Wenn der Workspace eines anderen Agenten derselbe Pfad ist, innerhalb dieses Workspaces liegt oder diesen Workspace enthält, bleibt der Workspace erhalten und --json meldet workspaceRetained, workspaceRetainedReason und workspaceSharedWith.

Identitätsdateien

Jeder Agenten-Workspace kann eine IDENTITY.md im Workspace-Stammverzeichnis enthalten:

• Beispielpfad: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity liest aus dem Workspace-Stammverzeichnis (oder aus einer expliziten --identity-file)

Avatar-Pfade werden relativ zum Workspace-Stammverzeichnis aufgelöst.

Identität festlegen

set-identity schreibt Felder in agents.list[].identity:

• name
• theme
• emoji
• avatar (workspace-relativer Pfad, http(s)-URL oder Data-URI)

Optionen:

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

Hinweise:

• Mit --agent oder --workspace können Sie den Zielagenten auswählen.
• Wenn Sie sich auf --workspace verlassen und mehrere Agenten diesen Workspace teilen, schlägt der Befehl fehl und fordert Sie auf, --agent zu übergeben.
• Lokale workspace-relative Avatar-Bilddateien sind auf 2 MB begrenzt. HTTP(S)-URLs und data:-URIs werden nicht mit der lokalen Dateigrößenbegrenzung geprüft.
• Wenn keine expliziten Identitätsfelder angegeben werden, liest der Befehl Identitätsdaten aus IDENTITY.md.

Aus IDENTITY.md laden:

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

Felder explizit überschreiben:

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

Konfigurationsbeispiel:

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

Verwandt

• CLI-Referenz
• Multi-Agent-Routing
• Agent-Workspace