--- read_when: - 複数の分離されたエージェント（ワークスペース + ルーティング + 認証）が必要な場合 summary: '`openclaw agents` の CLI リファレンス（一覧表示/追加/削除/バインディング/バインド/バインド解除/ID の設定）' title: エージェント x-i18n: generated_at: "2026-07-11T22:04:38Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 89b6c59a9ce0fd0514343cc3fa66ae5e6d963cdfa5c6f58ffe6b9a6b5e943f09 source_path: cli/agents.md workflow: 16 --- # `openclaw agents` 分離されたエージェント（ワークスペース + 認証 + ルーティング）を管理します。サブコマンドなしで `openclaw agents` を実行することは、`openclaw agents list` と同等です。 関連項目: - [マルチエージェントルーティング](/ja-JP/concepts/multi-agent) - [エージェントワークスペース](/ja-JP/concepts/agent-workspace) - [Skills 設定](/ja-JP/tools/skills-config): Skills の可視性設定。 ## 例 ```bash openclaw agents list openclaw agents list --bindings openclaw agents add work --workspace ~/.openclaw/workspace-work openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive 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 ``` ## コマンド一覧 ### `agents list` オプション: `--json`、`--bindings`（エージェントごとの件数や概要だけでなく、完全なルーティングルールを含めます）。 ### `agents add [name]` オプション: `--workspace `、`--model `、`--agent-dir `、`--bind `（繰り返し指定可能）、`--non-interactive`、`--json`。 - 明示的な追加用フラグをいずれか指定すると、コマンドは非対話パスに切り替わります。 - 非対話モードでは、エージェント名と `--workspace` の両方が必須です。 - `main` は予約済みであり、新しいエージェント ID として使用できません。 - 対話モードでは、認証情報が `copyToAgents: false` でコピーを拒否していない限り、移植可能な静的認証情報（`api_key` と静的な `token` プロファイル）のみをコピーして認証を初期設定します。OAuth 更新トークンのプロファイルは、プロバイダーが `copyToAgents: true` で明示的に許可しない限りコピーされません。コピーされない場合、OAuth は実際の `main` エージェントストアからの透過的な継承を通じてのみ利用できます。設定されたデフォルトエージェントが `main` でない場合は、新しいエージェントで OAuth プロファイルごとに別途サインインしてください。 ### `agents bindings` オプション: `--agent `、`--json`。 ### `agents bind` オプション: `--agent `（現在のデフォルトエージェントが既定値）、`--bind `（繰り返し指定可能）、`--json`。 ### `agents unbind` オプション: `--agent `（現在のデフォルトエージェントが既定値）、`--bind `（繰り返し指定可能）、`--all`、`--json`。`--all` または 1 つ以上の `--bind` 値のいずれかを指定できますが、両方は指定できません。 ### `agents set-identity` オプション: `--agent `、`--workspace `、`--identity-file `、`--from-identity`、`--name `、`--theme `、`--emoji `、`--avatar `、`--json`。以下の[アイデンティティの設定](#set-identity)を参照してください。 ### `agents delete ` オプション: `--force`、`--json`。 - `main` は削除できません。 - `--force` を指定しない場合は対話式の確認が必要です（非 TTY セッションでは失敗するため、`--force` を指定して再実行してください）。 - ワークスペース、エージェントの状態、セッショントランスクリプトの各ディレクトリは完全には削除されず、ゴミ箱へ移動されます。 - Gateway に接続できる場合、削除は Gateway 経由で処理されるため、設定とセッションストアのクリーンアップにはランタイムトラフィックと同じ書き込み処理が使用されます。Gateway に接続できない場合、CLI はオフラインのローカルパスにフォールバックします。 - 別のエージェントのワークスペースが同じパスである、このワークスペース内にある、またはこのワークスペースを含む場合、ワークスペースは保持され、`--json` で `workspaceRetained`、`workspaceRetainedReason`、`workspaceSharedWith` が報告されます。 ## ルーティングバインディング ルーティングバインディングを使用すると、チャネルからの受信トラフィックを特定のエージェントに固定できます。 エージェントごとに表示される Skills も変えたい場合は、`openclaw.json` で `agents.defaults.skills` と `agents.list[].skills` を設定します。[Skills 設定](/ja-JP/tools/skills-config)および[設定リファレンス](/ja-JP/gateway/config-agents#agentsdefaultsskills)を参照してください。 バインディングを一覧表示するには: ```bash openclaw agents bindings openclaw agents bindings --agent work openclaw agents bindings --json ``` バインディングを追加するには: ```bash openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a ``` エージェントの作成時にバインディングを追加することもできます: ```bash openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:* ``` `accountId` を省略した場合（`--bind `）、OpenClaw は Plugin のセットアップフック、強制されたアカウントバインディング、またはチャネルに設定されたアカウント数から解決します。 `bind` または `unbind` で `--agent` を省略すると、OpenClaw は現在のデフォルトエージェントを対象にします。 ### `--bind` の形式 | 形式 | 意味 | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------ | | `--bind :*` | チャネル上のすべてのアカウントに一致します。 | | `--bind :` | 1 つのアカウントに一致します。 | | `--bind ` | CLI が Plugin 固有のアカウントスコープを安全に解決できる場合を除き、デフォルトアカウントのみに一致します。 | ### バインディングのスコープ動作 - `accountId` なしで保存されたバインディングは、チャネルのデフォルトアカウントのみに一致します。 - `accountId: "*"` はチャネル全体のフォールバック（すべてのアカウント）であり、明示的なアカウントバインディングより優先度が低くなります。 - 同じエージェントに `accountId` なしの一致するチャネルバインディングがすでにあり、後から明示的または解決済みの `accountId` を指定してバインドすると、OpenClaw は重複を追加せず、既存のバインディングをその場でアップグレードします。 例: ```bash # チャネル上のすべてのアカウントに一致 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`）。 バインディングを削除するには: ```bash 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、またはデータ URI）の各フィールドを書き込みます。 - `--agent` または `--workspace` で対象エージェントを選択します。`--workspace` が複数のエージェントに一致する場合、コマンドは失敗し、`--agent` の指定を求めます。 - ローカルのワークスペース相対アバター画像ファイルは 2 MB までに制限されます。HTTP(S) URL と `data:` URI にはローカルファイルサイズの上限は適用されません。 - アイデンティティのフィールドを明示的に指定しない場合、コマンドは `IDENTITY.md` からアイデンティティデータを読み取ります。 `IDENTITY.md` から読み込むには: ```bash openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity ``` フィールドを明示的に上書きするには: ```bash openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png ``` 設定例: ```json5 { agents: { list: [ { id: "main", identity: { name: "OpenClaw", theme: "space lobster", emoji: "🦞", avatar: "avatars/openclaw.png", }, }, ], }, } ``` ## 関連項目 - [CLI リファレンス](/ja-JP/cli) - [マルチエージェントルーティング](/ja-JP/concepts/multi-agent) - [エージェントワークスペース](/ja-JP/concepts/agent-workspace)