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

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

エージェントとは、ワークスペースファイル、認証プロファイル、モデルレジストリ、セッションストアを含む、ペルソナごとの完全なスコープです。バインディングは、チャンネルアカウント（Slack ワークスペース、WhatsApp 番号など）をいずれかのエージェントに対応付けます。

1 つのエージェントとは

各エージェントは以下を個別に持ちます。

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

認証プロファイルはエージェントごとに管理され、以下から読み込まれます。

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

Skills は各エージェントのワークスペースと ~/.openclaw/skills などの共有ルートから読み込まれ、その後、有効なエージェントの Skills 許可リストによって絞り込まれます。共有ベースラインには agents.defaults.skills を使用し、エージェントごとの置き換えには agents.entries.*.skills を使用します（明示的なエントリはデフォルトを置き換え、マージはしません）。Skills: エージェントごとと共有の違いおよびSkills: エージェントの許可リストを参照してください。

Plugin が所有するストレージは、その Plugin の設定に従います。2 番目のエージェントを追加しても、 すべてのグローバル Plugin ストアが自動的に分割されるわけではありません。たとえば、ペルソナ間で コンパイル済みの Wiki ナレッジを共有してはならない場合は、 エージェントごとの Memory Wiki ボールト を設定してください。

パス

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

何も設定しない場合、OpenClaw は 1 つのエージェントを実行します。

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

エージェントヘルパー

新しい分離エージェントを追加します。

openclaw agents add work

フラグ: --workspace <dir>、--model <id>、--agent-dir <dir>、--bind <channel[:accountId]>（繰り返し指定可能）、--non-interactive（--workspace が必要）。

受信メッセージをルーティングするには 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）。
• 認証とセッションを分離し、エージェント間アクセスは明示的な機能または Plugin 設定によってのみ有効化。

これにより、エージェントのコア状態を分離したまま、複数のユーザーが 1 つの Gateway を共有できます。

エージェントごとの Memory Wiki ボールト

Memory Wiki はデフォルトで 1 つのグローバルボールトを使用します。サポートエージェントの コンパイル済みナレッジをマーケティングエージェントのものと分離するには、 plugins.entries.memory-wiki.config.vault.scope を agent に設定します。

{  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vault: {            scope: "agent",            path: "~/.openclaw/wiki",          },        },      },    },  },}

設定したパスは親ディレクトリです。OpenClaw は正規化された エージェント ID を追加し、~/.openclaw/wiki/support や ~/.openclaw/wiki/marketing のようなパスを生成します。複数のエージェントが設定されている場合、 エージェントスコープの CLI および Gateway 操作には エージェントの明示的な指定が必要です。ブリッジの フィルタリング、移行、信頼境界の詳細については、エージェントごとの Memory Wiki ボールトを参照してください。

エージェント間の QMD メモリ検索

あるエージェントから別のエージェントの QMD セッショントランスクリプトを検索できるようにするには、agents.entries.*.memory.search.qmd.extraCollections 配下に追加のコレクションを設定します。すべてのエージェントで同じコレクションを共有する場合は、memory.search.qmd.extraCollections を使用します。

{  agents: {    defaults: {      workspace: "~/workspaces/main",    },    entries: {      main: {        workspace: "~/workspaces/main",        memory: {          search: {            qmd: {              extraCollections: [{ path: "notes" }], // ワークスペース内で解決される -> "notes-main" という名前のコレクション            },          },        },      },      family: { workspace: "~/workspaces/family" },    },  },  memory: {    backend: "qmd",    search: {      qmd: {        extraCollections: [{ path: "~/agents/family/sessions", name: "family-sessions" }],      },    },    qmd: { includeDefaultMemory: false },  },}

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

1 つの WhatsApp 番号を複数人で使用する（DM の分割）

peer.kind: "direct" で送信者の E.164（+15551234567）を照合することにより、1 つの WhatsApp アカウント上で異なる WhatsApp DM を別々のエージェントへルーティングします。返信は引き続き同じ 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 つのエージェントにバインドするか、ブロードキャストグループを使用してください。

ルーティングルール

バインディングは決定的であり、最も具体的なものが優先されます。階層の完全な順序（完全一致するピア、親ピア、ピアのワイルドカード、ギルド＋ロール、ギルド、チーム、アカウント、チャンネル、デフォルトエージェント）については、チャンネルルーティングを参照してください。ここでは、特に重要ないくつかのルールを示します。

• 同じ階層内で複数のバインディングが一致する場合、設定内で最初に記述されたものが優先されます。
• バインディングに複数の照合フィールド（例: peer ＋ guildId）が設定されている場合、指定されたすべてのフィールドが一致する必要があります（AND のセマンティクス）。
• accountId を省略したバインディングは、すべてのアカウントではなく、デフォルトアカウントのみに一致します。チャンネル全体のフォールバックには accountId: "*" を使用し、特定の 1 アカウントには accountId: "<name>" を使用します。同じバインディングを明示的なアカウント ID とともに再度追加すると、重複を作成せず、既存のチャンネルのみのバインディングが更新されます。

複数のアカウント／電話番号

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

accountId が省略された場合に使用するアカウントを選択するには、channels.<channel>.defaultAccount を設定します。未設定の場合、OpenClaw は default があればそれを使用し、なければ設定済みアカウント ID の先頭（並べ替え後）を使用します。

複数のアカウントをサポートするチャンネル: discord、feishu、googlechat、imessage、irc、line、mattermost、matrix、nextcloud-talk、nostr、signal、slack、telegram、whatsapp、zalo、zalouser。

概念

• agentId: 1 つの「頭脳」（ワークスペース、エージェントごとの認証、エージェントごとのセッションストア）。
• accountId: 1 つのチャンネルアカウントインスタンス（例: WhatsApp アカウント personal と biz）。
• binding: (channel, accountId, peer)、および必要に応じてギルド ID／チーム ID に基づいて、受信メッセージを agentId にルーティングします。
• ダイレクトチャットは agent:<agentId>:<mainKey> に集約されます（エージェントごとの「メイン」。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",      },    ],  },   // 決定的なルーティング: 最初に一致したものが優先されます（具体性の高いものを先にします）。  bindings: [    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },     // ピアごとの任意のオーバーライド（例: 特定のグループを仕事用エージェントに送信）。    {      agentId: "work",      match: {        channel: "whatsapp",        accountId: "personal",        peer: { kind: "group", id: "1203630...@g.us" },      },    },  ],   // デフォルトでは無効: エージェント間メッセージングは明示的に有効化し、許可リストに追加する必要があります。  tools: {    agentToAgent: {      enabled: false,      allow: ["home", "work"],    },  },   channels: {    whatsapp: {      accounts: {        personal: {          // 任意のオーバーライド。デフォルト: ~/.openclaw/credentials/whatsapp/personal          // authDir: "~/.openclaw/credentials/whatsapp/personal",        },        biz: {          // 任意のオーバーライド。デフォルト: ~/.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",  // 個人用エージェントにはサンドボックスを使用しない        },        // ツール制限なし - すべてのツールを利用可能      },      {        id: "family",        workspace: "~/.openclaw/workspace-family",        sandbox: {          mode: "all",     // 常にサンドボックス化          scope: "agent",  // エージェントごとに 1 つのコンテナ          docker: {            // コンテナ作成後に任意で 1 回だけ実行するセットアップ            setupCommand: "apt-get update && apt-get install -y git curl",          },        },        tools: {          allow: ["read"],                    // read ツールのみ          deny: ["exec", "write", "edit", "apply_patch"],    // その他を拒否        },      },    ],  },}

これにより、次のことが可能になります。

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

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

関連項目

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