マルチエージェントルーティング

複数の_分離された_エージェントを実行します。各エージェントは独自のワークスペース、状態ディレクトリ（agentDir）、セッション履歴を持ち、さらに 1 つの実行中 Gateway 内で複数のチャネルアカウント（例: 2 つの WhatsApp）を扱えます。受信メッセージは bindings を通じて適切なエージェントへルーティングされます。

ここでのエージェントは、ワークスペースファイル、認証プロファイル、モデルレジストリ、セッションストアを含む、ペルソナごとの完全なスコープです。agentDir は、このエージェントごとの設定を ~/.openclaw/agents/<agentId>/ に保持するディスク上の状態ディレクトリです。binding は、チャネルアカウント（例: Slack ワークスペースや WhatsApp 番号）をそれらのエージェントの 1 つに対応付けます。

「1 つのエージェント」とは何か？

エージェントは、独自の以下を持つ完全にスコープ化された頭脳です。

• ワークスペース（ファイル、AGENTS.md/SOUL.md/USER.md、ローカルノート、ペルソナルール）。
• 認証プロファイル、モデルレジストリ、エージェントごとの設定のための状態ディレクトリ（agentDir）。
• ~/.openclaw/agents/<agentId>/sessions 配下のセッションストア（チャット履歴 + ルーティング状態）。

認証プロファイルはエージェントごとです。各エージェントは自身の以下から読み込みます。

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

Skills は各エージェントワークスペースと ~/.openclaw/skills などの共有ルートから読み込まれ、設定されている場合は有効なエージェント Skills 許可リストでフィルタリングされます。共有ベースラインには agents.defaults.skills を、エージェントごとの置き換えには agents.list[].skills を使用します。Skills: エージェントごとと共有 および Skills: エージェント Skills 許可リスト を参照してください。

Gateway は1 つのエージェント（デフォルト）または複数のエージェントを並べてホストできます。

パス（クイックマップ）

• 設定: ~/.openclaw/openclaw.json（または OPENCLAW_CONFIG_PATH）
• 状態ディレクトリ: ~/.openclaw（または OPENCLAW_STATE_DIR）
• ワークスペース: ~/.openclaw/workspace（または ~/.openclaw/workspace-<agentId>）
• エージェントディレクトリ: ~/.openclaw/agents/<agentId>/agent（または agents.list[].agentDir）
• セッション: ~/.openclaw/agents/<agentId>/sessions

単一エージェントモード（デフォルト）

何もしない場合、OpenClaw は単一のエージェントを実行します。

• agentId のデフォルトは main です。
• セッションは agent:main:<mainKey> としてキー付けされます。
• ワークスペースのデフォルトは ~/.openclaw/workspace です（OPENCLAW_PROFILE が設定されている場合は ~/.openclaw/workspace-<profile>）。
• 状態のデフォルトは ~/.openclaw/agents/main/agent です。

エージェントヘルパー

agent ウィザードを使用して、新しい分離エージェントを追加します。

openclaw agents add work

次に、受信メッセージをルーティングするために bindings を追加します（またはウィザードに任せます）。

以下で確認します。

openclaw agents list --bindings

クイックスタート

openclaw agents add codingopenclaw agents add social

openclaw channels login --channel whatsapp --account work

openclaw gateway restartopenclaw agents list --bindingsopenclaw channels status --probe

複数のエージェント = 複数の人、複数の人格

複数のエージェントでは、各 agentId が完全に分離されたペルソナになります。

• 異なる電話番号/アカウント（チャネルごとの accountId）。
• 異なる人格（AGENTS.md や SOUL.md などのエージェントごとのワークスペースファイル）。
• 分離された認証 + セッション（明示的に有効化しない限り相互干渉なし）。

これにより、複数の人が 1 つの Gateway サーバーを共有しながら、それぞれの AI「頭脳」とデータを分離できます。

クロスエージェント QMD メモリ検索

あるエージェントが別のエージェントの QMD セッショントランスクリプトを検索する必要がある場合は、agents.list[].memorySearch.qmd.extraCollections 配下に追加コレクションを追加します。すべてのエージェントが同じ共有トランスクリプトコレクションを継承する必要がある場合にのみ、agents.defaults.memorySearch.qmd.extraCollections を使用してください。

{  agents: {    defaults: {      workspace: "~/workspaces/main",      memorySearch: {        qmd: {          extraCollections: [{ path: "~/agents/family/sessions", name: "family-sessions" }],        },      },    },    list: [      {        id: "main",        workspace: "~/workspaces/main",        memorySearch: {          qmd: {            extraCollections: [{ path: "notes" }], // resolves inside workspace -> collection named "notes-main"          },        },      },      { id: "family", workspace: "~/workspaces/family" },    ],  },  memory: {    backend: "qmd",    qmd: { includeDefaultMemory: false },  },}

追加コレクションのパスはエージェント間で共有できますが、そのパスがエージェントワークスペースの外側にある場合、コレクション名は明示的なままです。ワークスペース内のパスはエージェントスコープのままなので、各エージェントは独自のトランスクリプト検索セットを保持します。

1 つの WhatsApp 番号、複数の人（DM 分割）

1 つの WhatsApp アカウントのまま、異なる WhatsApp DM を異なるエージェントにルーティングできます。peer.kind: "direct" を使用し、送信者 E.164（例: +15551234567）で照合します。返信は引き続き同じ WhatsApp 番号から送信されます（エージェントごとの送信者 ID はありません）。

例:

{  agents: {    list: [      { id: "alex", workspace: "~/.openclaw/workspace-alex" },      { id: "mia", workspace: "~/.openclaw/workspace-mia" },    ],  },  bindings: [    {      agentId: "alex",      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230001" } },    },    {      agentId: "mia",      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230002" } },    },  ],  channels: {    whatsapp: {      dmPolicy: "allowlist",      allowFrom: ["+15551230001", "+15551230002"],    },  },}

注:

• DM アクセス制御はWhatsApp アカウントごとのグローバル（ペアリング/許可リスト）であり、エージェントごとではありません。
• 共有グループでは、グループを 1 つのエージェントに binding するか、ブロードキャストグループ を使用します。

ルーティングルール（メッセージがエージェントを選ぶ仕組み）

Bindings は決定的で、最も具体的なものが優先されます。

複数アカウント / 電話番号

複数アカウントをサポートするチャネル（例: WhatsApp）は、各ログインを識別するために accountId を使用します。各 accountId は異なるエージェントにルーティングできるため、1 つのサーバーで複数の電話番号をホストし、セッションを混在させずに済みます。

accountId が省略された場合にチャネル全体のデフォルトアカウントを使用したい場合は、channels.<channel>.defaultAccount（任意）を設定します。未設定の場合、OpenClaw は default が存在すればそれにフォールバックし、なければ設定済みアカウント ID の最初（ソート済み）にフォールバックします。

このパターンをサポートする一般的なチャネルには以下があります。

• whatsapp, telegram, discord, slack, signal, imessage
• irc, line, googlechat, mattermost, matrix, nextcloud-talk
• zalo, zalouser, nostr, feishu

概念

• agentId: 1 つの「頭脳」（ワークスペース、エージェントごとの認証、エージェントごとのセッションストア）。
• accountId: 1 つのチャネルアカウントインスタンス（例: WhatsApp アカウント "personal" と "biz"）。
• binding: (channel, accountId, peer) と任意の guild/team ID によって、受信メッセージを agentId にルーティングします。
• ダイレクトチャットは agent:<agentId>:<mainKey>（エージェントごとの「main」、session.mainKey）に集約されます。

プラットフォーム例

{  agents: {    list: [      { id: "main", workspace: "~/.openclaw/workspace-main" },      { id: "coding", workspace: "~/.openclaw/workspace-coding" },    ],  },  bindings: [    { agentId: "main", match: { channel: "discord", accountId: "default" } },    { agentId: "coding", match: { channel: "discord", accountId: "coding" } },  ],  channels: {    discord: {      groupPolicy: "allowlist",      accounts: {        default: {          token: "DISCORD_BOT_TOKEN_MAIN",          guilds: {            "123456789012345678": {              channels: {                "222222222222222222": { allow: true, requireMention: false },              },            },          },        },        coding: {          token: "DISCORD_BOT_TOKEN_CODING",          guilds: {            "123456789012345678": {              channels: {                "333333333333333333": { allow: true, requireMention: false },              },            },          },        },      },    },  },}

{  agents: {    list: [      { id: "main", workspace: "~/.openclaw/workspace-main" },      { id: "alerts", workspace: "~/.openclaw/workspace-alerts" },    ],  },  bindings: [    { agentId: "main", match: { channel: "telegram", accountId: "default" } },    { agentId: "alerts", match: { channel: "telegram", accountId: "alerts" } },  ],  channels: {    telegram: {      accounts: {        default: {          botToken: "123456:ABC...",          dmPolicy: "pairing",        },        alerts: {          botToken: "987654:XYZ...",          dmPolicy: "allowlist",          allowFrom: ["tg:123456789"],        },      },    },  },}

openclaw channels login --channel whatsapp --account personalopenclaw channels login --channel whatsapp --account biz

{  agents: {    list: [      {        id: "home",        default: true,        name: "Home",        workspace: "~/.openclaw/workspace-home",        agentDir: "~/.openclaw/agents/home/agent",      },      {        id: "work",        name: "Work",        workspace: "~/.openclaw/workspace-work",        agentDir: "~/.openclaw/agents/work/agent",      },    ],  },   // Deterministic routing: first match wins (most-specific first).  bindings: [    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },     // Optional per-peer override (example: send a specific group to work agent).    {      agentId: "work",      match: {        channel: "whatsapp",        accountId: "personal",        peer: { kind: "group", id: "1203630...@g.us" },      },    },  ],   // Off by default: agent-to-agent messaging must be explicitly enabled + allowlisted.  tools: {    agentToAgent: {      enabled: false,      allow: ["home", "work"],    },  },   channels: {    whatsapp: {      accounts: {        personal: {          // Optional override. Default: ~/.openclaw/credentials/whatsapp/personal          // authDir: "~/.openclaw/credentials/whatsapp/personal",        },        biz: {          // Optional override. Default: ~/.openclaw/credentials/whatsapp/biz          // authDir: "~/.openclaw/credentials/whatsapp/biz",        },      },    },  },}

一般的なパターン

{  agents: {    list: [      {        id: "chat",        name: "Everyday",        workspace: "~/.openclaw/workspace-chat",        model: "anthropic/claude-sonnet-4-6",      },      {        id: "opus",        name: "Deep Work",        workspace: "~/.openclaw/workspace-opus",        model: "anthropic/claude-opus-4-6",      },    ],  },  bindings: [    { agentId: "chat", match: { channel: "whatsapp", accountId: "*" } },    { agentId: "opus", match: { channel: "telegram", accountId: "*" } },  ],}

{  agents: {    list: [      {        id: "chat",        name: "Everyday",        workspace: "~/.openclaw/workspace-chat",        model: "anthropic/claude-sonnet-4-6",      },      {        id: "opus",        name: "Deep Work",        workspace: "~/.openclaw/workspace-opus",        model: "anthropic/claude-opus-4-6",      },    ],  },  bindings: [    {      agentId: "opus",      match: { channel: "whatsapp", accountId: "*", peer: { kind: "direct", id: "+15551234567" } },    },    { agentId: "chat", match: { channel: "whatsapp", accountId: "*" } },  ],}

{  agents: {    list: [      {        id: "family",        name: "Family",        workspace: "~/.openclaw/workspace-family",        identity: { name: "Family Bot" },        groupChat: {          mentionPatterns: ["@family", "@familybot", "@Family Bot"],        },        sandbox: {          mode: "all",          scope: "agent",        },        tools: {          allow: [            "exec",            "read",            "sessions_list",            "sessions_history",            "sessions_send",            "sessions_spawn",            "session_status",          ],          deny: ["write", "edit", "apply_patch", "browser", "canvas", "nodes", "cron"],        },      },    ],  },  bindings: [    {      agentId: "family",      match: {        channel: "whatsapp",        peer: { kind: "group", id: "120363999999999999@g.us" },      },    },  ],}

エージェントごとのサンドボックスとツール設定

各エージェントは独自のサンドボックスとツール制限を持てます。

{  agents: {    list: [      {        id: "personal",        workspace: "~/.openclaw/workspace-personal",        sandbox: {          mode: "off",  // No sandbox for personal agent        },        // No tool restrictions - all tools available      },      {        id: "family",        workspace: "~/.openclaw/workspace-family",        sandbox: {          mode: "all",     // Always sandboxed          scope: "agent",  // One container per agent          docker: {            // Optional one-time setup after container creation            setupCommand: "apt-get update && apt-get install -y git curl",          },        },        tools: {          allow: ["read"],                    // Only read tool          deny: ["exec", "write", "edit", "apply_patch"],    // Deny others        },      },    ],  },}

利点:

• セキュリティ分離: 信頼できないエージェントのツールを制限します。
• リソース制御: 特定のエージェントをサンドボックス化し、他はホスト上に維持します。
• 柔軟なポリシー: エージェントごとに異なる権限を設定できます。

詳細な例は マルチエージェントのサンドボックスとツール を参照してください。

関連

• ACP エージェント — 外部コーディングハーネスの実行
• チャンネルルーティング — メッセージがエージェントにルーティングされる仕組み
• プレゼンス — エージェントのプレゼンスと可用性
• セッション — セッション分離とルーティング
• サブエージェント — バックグラウンドエージェント実行の起動