OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Agenten

openclaw agents

Isolierte Agenten verwalten (Arbeitsbereiche + Authentifizierung + Routing). Das Ausführen von openclaw agents ohne Unterbefehl entspricht openclaw agents list.

Verwandte Themen:

Beispiele

bash
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

Befehlsoberfläche

agents list

Optionen: --json, --bindings (vollständige Routingregeln einschließen, nicht nur Anzahl/Zusammenfassungen pro Agent).

agents add [name]

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

  • Durch die Angabe eines beliebigen expliziten Hinzufügen-Flags wechselt der Befehl in den nicht interaktiven Ablauf.
  • 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 wird die Authentifizierung vorbereitet, indem nur portable statische Anmeldedaten (api_key und statische token-Profile) kopiert werden, sofern Anmeldedaten dies nicht mit copyToAgents: false ablehnen; OAuth-Profile mit Aktualisierungstoken werden nur kopiert, wenn ein Provider dies mit copyToAgents: true aktiviert. Ohne Kopie bleibt OAuth nur durch durchgreifende Vererbung aus dem tatsächlichen Speicher des Agenten main verfügbar. Wenn der konfigurierte Standardagent nicht main ist, melden Sie sich für OAuth-Profile auf dem neuen Agenten separat 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. Akzeptiert entweder --all oder einen oder mehrere --bind-Werte, jedoch nicht beides.

agents set-identity

Optionen: --agent <id>, --workspace <dir>, --identity-file <path>, --from-identity, --name <name>, --theme <theme>, --emoji <emoji>, --avatar <value>, --json. Siehe unten Identität festlegen.

agents delete <id>

Optionen: --force, --json.

  • main kann nicht gelöscht werden.
  • Ohne --force ist eine interaktive Bestätigung erforderlich (schlägt in einer Nicht-TTY-Sitzung fehl; führen Sie den Befehl erneut mit --force aus).
  • Die Verzeichnisse für Arbeitsbereich, Agentenstatus und Sitzungstranskripte werden in den Papierkorb verschoben und nicht endgültig gelöscht. Wenn der Papierkorb nicht verfügbar ist, wird die Agentenkonfiguration dennoch erfolgreich gelöscht, und die Pfade, die manuell bereinigt werden müssen, werden gemeldet.
  • Wenn das Gateway erreichbar ist, erfolgt das Löschen über das Gateway, sodass die Bereinigung der Konfiguration und des Sitzungsspeichers denselben Schreibmechanismus wie der Laufzeitverkehr verwendet. Wenn das Gateway nicht erreichbar ist, greift die CLI auf den lokalen Offlinepfad zurück.
  • Wenn der Arbeitsbereich eines anderen Agenten denselben Pfad verwendet, innerhalb dieses Arbeitsbereichs liegt oder diesen Arbeitsbereich enthält, bleibt der Arbeitsbereich erhalten, und --json meldet workspaceRetained, workspaceRetainedReason und workspaceSharedWith.

Routingbindungen

Verwenden Sie Routingbindungen, um eingehenden Kanalverkehr einem bestimmten Agenten fest zuzuordnen.

Wenn Sie außerdem unterschiedliche sichtbare Skills pro Agent wünschen, konfigurieren Sie agents.defaults.skills und agents.entries.*.skills in openclaw.json. Siehe Skills-Konfiguration und Konfigurationsreferenz.

Bindungen auflisten:

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

Bindungen hinzufügen:

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

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

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

Wenn Sie accountId (--bind <channel>) weglassen, löst OpenClaw den Wert über Einrichtungs-Hooks des Plugins, eine erzwungene Kontobindung oder die konfigurierte Kontoanzahl des Kanals auf.

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

Format von --bind

Format Bedeutung
--bind <channel>:* Entspricht allen Konten des Kanals.
--bind <channel>:<account> Entspricht einem Konto.
--bind <channel> Entspricht nur dem Standardkonto, sofern die CLI einen Plugin-spezifischen Kontobereich nicht sicher auflösen kann.

Verhalten des Bindungsbereichs

  • Eine gespeicherte Bindung ohne accountId entspricht nur dem Standardkonto des Kanals.
  • accountId: "*" ist der kanalweite Fallback (alle Konten) und weniger spezifisch als eine explizite Kontobindung.
  • Wenn derselbe Agent bereits eine passende Kanalbindung ohne accountId besitzt und Sie später eine Bindung mit einer expliziten oder aufgelösten Angabe für accountId erstellen, aktualisiert OpenClaw diese bestehende Bindung direkt, anstatt ein Duplikat hinzuzufügen.

Beispiele:

bash
# allen Konten des Kanals entsprechenopenclaw agents bind --agent work --bind telegram:* # einem bestimmten Konto entsprechenopenclaw agents bind --agent work --bind telegram:ops # anfängliche reine Kanalbindungopenclaw agents bind --agent work --bind telegram # später auf eine kontobezogene Bindung aktualisierenopenclaw agents bind --agent work --bind telegram:alerts

Nach der Aktualisierung ist das Routing für diese Bindung auf telegram:alerts beschränkt. Wenn Sie auch ein Routing für das Standardkonto wünschen, fügen Sie es explizit hinzu (zum Beispiel --bind telegram:default).

Bindungen entfernen:

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

Identitätsdateien

Jeder Agentenarbeitsbereich kann eine IDENTITY.md im Stammverzeichnis des Arbeitsbereichs enthalten:

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

Avatarpfade werden relativ zum Stammverzeichnis des Arbeitsbereichs aufgelöst und können dieses auch über einen symbolischen Link nicht verlassen.

Identität festlegen

set-identity schreibt Felder in agents.entries.*.identity: name, theme, emoji, avatar (arbeitsbereichsrelativer Pfad, HTTP(S)-URL oder Daten-URI).

  • --agent oder --workspace wählt den Zielagenten aus. Wenn --workspace mit mehr als einem Agenten übereinstimmt, schlägt der Befehl fehl und fordert Sie auf, --agent anzugeben.
  • Lokale, arbeitsbereichsrelative Avatarbilddateien sind auf 2 MB begrenzt. HTTP(S)-URLs und data:-URIs werden nicht anhand der lokalen Dateigrößenbeschränkung geprüft.
  • Wenn keine expliziten Identitätsfelder angegeben werden, liest der Befehl die Identitätsdaten aus IDENTITY.md.

Aus IDENTITY.md laden:

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

Felder explizit überschreiben:

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

Konfigurationsbeispiel:

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

Verwandte Themen

Was this useful?
On this page

On this page