openclaw agents

分離されたエージェント（ワークスペース + 認証 + ルーティング）を管理します。サブコマンドなしで openclaw agents を実行することは、openclaw agents list と同等です。

関連項目:

• マルチエージェントルーティング
• エージェントワークスペース
• Skills 設定: Skills の可視性設定。

例

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

コマンド一覧

agents list

オプション: --json、--bindings（エージェントごとの件数や概要だけでなく、完全なルーティングルールを含めます）。

agents add [name]

オプション: --workspace <dir>、--model <id>、--agent-dir <dir>、--bind <channel[:accountId]>（繰り返し指定可能）、--non-interactive、--json。

• 明示的な追加用フラグをいずれか指定すると、コマンドは非対話パスに切り替わります。
• 非対話モードでは、エージェント名と --workspace の両方が必須です。
• main は予約済みであり、新しいエージェント ID として使用できません。
• 対話モードでは、認証情報が copyToAgents: false でコピーを拒否していない限り、移植可能な静的認証情報（api_key と静的な token プロファイル）のみをコピーして認証を初期設定します。OAuth 更新トークンのプロファイルは、プロバイダーが copyToAgents: true で明示的に許可しない限りコピーされません。コピーされない場合、OAuth は実際の main エージェントストアからの透過的な継承を通じてのみ利用できます。設定されたデフォルトエージェントが main でない場合は、新しいエージェントで OAuth プロファイルごとに別途サインインしてください。

agents bindings

オプション: --agent <id>、--json。

agents bind

オプション: --agent <id>（現在のデフォルトエージェントが既定値）、--bind <channel[:accountId]>（繰り返し指定可能）、--json。

agents unbind

オプション: --agent <id>（現在のデフォルトエージェントが既定値）、--bind <channel[:accountId]>（繰り返し指定可能）、--all、--json。--all または 1 つ以上の --bind 値のいずれかを指定できますが、両方は指定できません。

agents set-identity

オプション: --agent <id>、--workspace <dir>、--identity-file <path>、--from-identity、--name <name>、--theme <theme>、--emoji <emoji>、--avatar <value>、--json。以下のアイデンティティの設定を参照してください。

agents delete <id>

オプション: --force、--json。

• main は削除できません。
• --force を指定しない場合は対話式の確認が必要です（非 TTY セッションでは失敗するため、--force を指定して再実行してください）。
• ワークスペース、エージェントの状態、セッショントランスクリプトの各ディレクトリは完全には削除されず、ゴミ箱へ移動されます。
• Gateway に接続できる場合、削除は Gateway 経由で処理されるため、設定とセッションストアのクリーンアップにはランタイムトラフィックと同じ書き込み処理が使用されます。Gateway に接続できない場合、CLI はオフラインのローカルパスにフォールバックします。
• 別のエージェントのワークスペースが同じパスである、このワークスペース内にある、またはこのワークスペースを含む場合、ワークスペースは保持され、--json で workspaceRetained、workspaceRetainedReason、workspaceSharedWith が報告されます。

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

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

エージェントごとに表示される Skills も変えたい場合は、openclaw.json で agents.defaults.skills と agents.list[].skills を設定します。Skills 設定および設定リファレンスを参照してください。

バインディングを一覧表示するには:

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

バインディングを追加するには:

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

エージェントの作成時にバインディングを追加することもできます:

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

accountId を省略した場合（--bind <channel>）、OpenClaw は Plugin のセットアップフック、強制されたアカウントバインディング、またはチャネルに設定されたアカウント数から解決します。

bind または unbind で --agent を省略すると、OpenClaw は現在のデフォルトエージェントを対象にします。

--bind の形式

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

• accountId なしで保存されたバインディングは、チャネルのデフォルトアカウントのみに一致します。
• accountId: "*" はチャネル全体のフォールバック（すべてのアカウント）であり、明示的なアカウントバインディングより優先度が低くなります。
• 同じエージェントに accountId なしの一致するチャネルバインディングがすでにあり、後から明示的または解決済みの accountId を指定してバインドすると、OpenClaw は重複を追加せず、既存のバインディングをその場でアップグレードします。

例:

# チャネル上のすべてのアカウントに一致openclaw agents bind --agent work --bind telegram:* # 特定のアカウントに一致openclaw agents bind --agent work --bind telegram:ops # 最初はチャネルのみをバインドopenclaw agents bind --agent work --bind telegram # 後でアカウントスコープのバインディングにアップグレードopenclaw agents bind --agent work --bind telegram:alerts

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

バインディングを削除するには:

openclaw agents unbind --agent work --bind telegram:opsopenclaw 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、またはデータ URI）の各フィールドを書き込みます。

• --agent または --workspace で対象エージェントを選択します。--workspace が複数のエージェントに一致する場合、コマンドは失敗し、--agent の指定を求めます。
• ローカルのワークスペース相対アバター画像ファイルは 2 MB までに制限されます。HTTP(S) URL と data: URI にはローカルファイルサイズの上限は適用されません。
• アイデンティティのフィールドを明示的に指定しない場合、コマンドは IDENTITY.md からアイデンティティデータを読み取ります。

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",        },      },    ],  },}

関連項目

• CLI リファレンス
• マルチエージェントルーティング
• エージェントワークスペース