Skip to main content

​
openclaw agents

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

​
Beispiele

​
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:
Bindungen hinzufügen:
Sie können Bindungen auch beim Erstellen eines Agenten hinzufügen:
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

​
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:
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:

​
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:
Felder explizit überschreiben:
Konfigurationsbeispiel:

​
Verwandte Themen