openclaw agents
分離されたエージェント（ワークスペース + 認証 + ルーティング）を管理します。サブコマンドなしで openclaw agents を実行することは、openclaw agents list と同等です。
関連:
- マルチエージェントルーティング
- エージェントワークスペース
- Skills 設定: skill の可視性設定。
例
コマンド一覧
agents list
オプション: --json、--bindings（エージェントごとの件数や概要だけでなく、完全なルーティングルールを含めます）。
agents add [name]
オプション: --workspace <dir>、--model <id>、--agent-dir <dir>、--bind <channel[:accountId]>（繰り返し指定可）、--non-interactive、--json。
- 明示的な追加フラグを渡すと、コマンドは非対話パスに切り替わります。
- 非対話モードでは、エージェント名と
--workspaceの両方が必要です。 mainは予約済みで、新しいエージェント ID としては使用できません。- 対話モードでは、認証はポータブルな静的認証情報（
api_keyと静的なtokenプロファイル）のみをコピーしてシードします。ただし、認証情報がcopyToAgents: falseで除外している場合はコピーされません。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 経由でルーティングされるため、設定とセッションストアのクリーンアップはランタイムトラフィックと同じ writer を共有します。Gateway に到達できない場合、CLI はオフラインのローカルパスへフォールバックします。
- 別のエージェントのワークスペースが同じパス、このワークスペース内、またはこのワークスペースを含む場合、ワークスペースは保持され、
--jsonはworkspaceRetained、workspaceRetainedReason、workspaceSharedWithを報告します。
ルーティングバインディング
ルーティングバインディングを使用して、受信チャネルのトラフィックを特定のエージェントに固定します。 エージェントごとに表示される Skills も変えたい場合は、openclaw.json の agents.defaults.skills と agents.list[].skills を設定してください。Skills 設定 と 設定リファレンス を参照してください。
バインディングを一覧表示します:
accountId（--bind <channel>）を省略すると、OpenClaw は Plugin セットアップフック、強制アカウントバインディング、またはチャネルの設定済みアカウント数から解決します。
bind または unbind で --agent を省略すると、OpenClaw は現在のデフォルトエージェントを対象にします。
--bind 形式
| 形式 | 意味 |
|---|---|
--bind <channel>:* | チャネル上のすべてのアカウントに一致します。 |
--bind <channel>:<account> | 1 つのアカウントに一致します。 |
--bind <channel> | CLI が Plugin 固有のアカウントスコープを安全に解決できる場合を除き、デフォルトアカウントのみに一致します。 |
バインディングスコープの動作
accountIdなしで保存されたバインディングは、チャネルのデフォルトアカウントのみに一致します。accountId: "*"はチャネル全体のフォールバック（すべてのアカウント）であり、明示的なアカウントバインディングより具体性が低くなります。- 同じエージェントに
accountIdなしの一致するチャネルバインディングがすでにあり、後から明示的または解決済みのaccountIdでバインドすると、OpenClaw は重複を追加するのではなく、その既存バインディングをその場でアップグレードします。
telegram:alerts にスコープされます。デフォルトアカウントのルーティングも必要な場合は、明示的に追加してください（例: --bind telegram:default）。
バインディングを削除します:
アイデンティティファイル
各エージェントワークスペースは、ワークスペースルートに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）。
--agentまたは--workspaceが対象エージェントを選択します。--workspaceが複数のエージェントに一致する場合、コマンドは失敗し、--agentを渡すよう求めます。- ローカルのワークスペース相対アバター画像ファイルは 2 MB に制限されます。HTTP(S) URL と
data:URI は、ローカルファイルサイズ制限の対象としてチェックされません。 - 明示的なアイデンティティフィールドが指定されていない場合、コマンドは
IDENTITY.mdからアイデンティティデータを読み取ります。
IDENTITY.md から読み込みます: