`openclaw agents`

分離されたエージェント（ワークスペース + 認証 + ルーティング）を管理します。

使用例

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

ルーティングバインディング

ルーティングバインディングを使用して、受信チャネルトラフィックを特定のエージェントに固定します。

バインディングの一覧表示：

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

バインディングの追加：

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

accountIdを省略した場合（--bind <channel>）、利用可能であればOpenClawがチャネルのデフォルトとプラグインセットアップフックから解決します。

バインディングスコープの動作

accountIdなしのバインディングは、チャネルのデフォルトアカウントのみにマッチします。
accountId: "*"はチャネル全体のフォールバック（全アカウント）で、明示的なアカウントバインディングよりも優先度が低くなります。
同じエージェントにaccountIdなしのチャネルバインディングが既に存在し、後から明示的または解決済みのaccountIdでバインドした場合、OpenClawは重複を追加するのではなく既存のバインディングをアップグレードします。

例：

# 初期のチャネルのみのバインディング
openclaw agents bind --agent work --bind telegram

# 後からアカウントスコープのバインディングにアップグレード
openclaw agents bind --agent work --bind telegram:ops

アップグレード後、そのバインディングのルーティングはtelegram:opsにスコープされます。デフォルトアカウントのルーティングも必要な場合は、明示的に追加してください（例：--bind telegram:default）。

バインディングの削除：

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

アイデンティティファイル

各エージェントワークスペースには、ワークスペースルートにIDENTITY.mdを含めることができます：

パスの例: ~/.openclaw/workspace/IDENTITY.md
set-identity --from-identityはワークスペースルート（または明示的な--identity-file）から読み込みます

アバターパスはワークスペースルートからの相対パスで解決されます。

アイデンティティの設定

set-identityはagents.list[].identityにフィールドを書き込みます：

name
theme
emoji
avatar（ワークスペース相対パス、http(s) URL、またはdata URI）

IDENTITY.mdから読み込み：

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

フィールドを明示的に上書き：

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

設定サンプル：

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