openclaw agents

Verwalte isolierte Agents (Workspaces + Auth + Routing).

Verwandte Themen:

• Multi-Agent-Routing: Multi-Agent Routing
• Agent-Workspace: Agent workspace

Beispiele

openclaw agents list
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents bindings
openclaw agents bind --agent work --bind telegram:ops
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
openclaw agents delete work

Routing-Bindings

Verwende Routing-Bindings, um eingehenden Channel-Traffic an einen bestimmten Agent zu binden.

Bindings auflisten:

openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json

Bindings hinzuf\u00fcgen:

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

Wenn du accountId wegl\u00e4sst (--bind <channel>), l\u00f6st OpenClaw es \u00fcber Channel-Defaults und Plugin-Setup-Hooks auf, sofern verf\u00fcgbar.

Binding-Scope-Verhalten

• Ein Binding ohne accountId matcht nur den Standard-Account des Channels.
• accountId: "*" ist der channel-weite Fallback (alle Accounts) und ist weniger spezifisch als ein explizites Account-Binding.
• Wenn derselbe Agent bereits ein passendes Channel-Binding ohne accountId hat und du sp\u00e4ter mit einer expliziten oder aufgel\u00f6sten accountId bindest, aktualisiert OpenClaw das bestehende Binding, statt ein Duplikat hinzuzuf\u00fcgen.

Beispiel:

# Initiales Channel-only-Binding
openclaw agents bind --agent work --bind telegram

# Sp\u00e4teres Upgrade auf account-bezogenes Binding
openclaw agents bind --agent work --bind telegram:ops

Nach dem Upgrade ist das Routing f\u00fcr dieses Binding auf telegram:ops beschr\u00e4nkt. Wenn du zus\u00e4tzlich Standard-Account-Routing willst, f\u00fcge es explizit hinzu (z.B. --bind telegram:default).

Bindings entfernen:

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

Identity-Dateien

Jeder Agent-Workspace kann eine IDENTITY.md im Workspace-Root enthalten:

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

Avatar-Pfade werden relativ zum Workspace-Root aufgel\u00f6st.

Identit\u00e4t setzen

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

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

Aus IDENTITY.md laden:

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

Felder explizit \u00fcberschreiben:

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

Config-Beispiel:

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