​

openclaw agents

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

​

例

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

​

agents add [name]

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

​

agents bindings

​

agents bind

​

agents unbind

​

agents set-identity

​

agents delete <id>

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

​

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

openclaw agents bindings
openclaw agents bindings --agent work
openclaw 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:*

​

--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

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

​

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

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

​

アイデンティティの設定

• --agent または --workspace で対象エージェントを選択します。--workspace が複数のエージェントに一致する場合、コマンドは失敗し、--agent を指定するよう求めます。
• ローカルのワークスペース相対アバター画像ファイルは 2 MB に制限されます。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",
        },
      },
    ],
  },
}

​

関連項目

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