OpenClaw マルチエージェント編成ガイド（2026）
単一の AI アシスタントは、さっとした質問には十分です。本番の開発、運用アラート、家族チャット、調査などには、セッション・認証情報・ツール権限を共有しない複数のペルソナが必要になります。OpenClaw マルチエージェント編成は、1 つの Gateway 制御プレーンと、ワークスペース・認証・セッションストアが分離された多数の agent でこれを実現します。
OpenClaw はローカルファーストのパーソナル AI アシスタント（2026 年時点で GitHub スター 37.5 万超）で、Gateway が WhatsApp・Telegram・Discord・Slack などのチャネルをエージェントの頭脳につなぎます。公式ドキュメントのマルチエージェントルーティングでは、受信メッセージが binding テーブルを通過し、クロストークなしで正しい agentId に届きます。
本ガイドでは次を扱います。
- ディスク上の OpenClaw「agent」の実体
- bindings によるメッセージルーティング（peer・account・channel）
- 2 つ目の agent を追加する 7 ステップ
- ルーティングを超えたマルチエージェント編成（委譲・ワークフロー）
- ネイティブ Gateway ルーティングと外部オーケストレーターの使い分け
すでに開発ワークフローに Obra Superpowers を使っている方や、リポジトリ把握に Understand Anything を使っている方にとって、OpenClaw は別レイヤーです。常時オンのアシスタント＋チャネルルーティングであり、IDE 内のコーディング専用ではありません。プラグイン選びは 2026 年おすすめ Claude Code プラグイン も参照してください。
はじめに
本番用途ではペルソナの分離が前提です。以下では agent の構成要素から順に説明します。
1 つの OpenClaw agent に含まれるもの
~/.openclaw/agents/<agentId>/ 配下の分離セッションストアを含む完全なペルソナスコープです。| コンポーネント | パス / 成果物 | 目的 |
|---|---|---|
| Workspace | ~/.openclaw/workspace-<name> など | 既定 cwd。SOUL.md、AGENTS.md、skills |
| Agent dir | ~/.openclaw/agents/<agentId>/agent | auth・モデルレジストリ・エージェント別設定 |
| Sessions | ~/.openclaw/agents/<agentId>/sessions | チャット履歴とルーティング状態 |
| Config | ~/.openclaw/openclaw.json | Gateway、agents.list、bindings、channels |
重要： 同じ agentDir を 2 つの agent で共有しないでください。auth とセッションが衝突します。
agentId・accountId・binding
| 概念 | 意味 |
|---|---|
agentId | 1 つの頭脳（workspace + sessions + auth） |
accountId | チャネル上の 1 ログイン（例：WhatsApp personal / biz） |
binding | (channel, accountId, peer, …) にマッチ → agentId へ |
ルーティングは決定論的です。最も具体的なルールが優先され、peer 単位はチャネル全体のデフォルトより上です。
Gateway アーキテクチャ（制御プレーン）
受信メッセージ（WhatsApp / Slack など）→ OpenClaw Gateway → bindings 読み込み → agentId 解決 → 各 agent の workspace + session へ → エージェント別ツール許可リストで LLM + tools + skills。
Gateway はルーター兼セッション管理であり、製品そのものではありません。各 agent は agents.list[].tools.allow/deny とオプションの sandbox（sandbox.mode: "all"）を持てます。
agent 間メッセージは既定で無効です：tools: { agentToAgent: { enabled: false, allow: ["home", "work"] } }。ペルソナ間の委譲が必要なときだけ有効化してください。
セットアップ手順：2 つ目の agent を追加
ステップ 1 — OpenClaw のインストールまたは更新
公式インストーラに従い、openclaw --version で CLI を確認します。
ステップ 2 — 新しい分離 agent の作成
openclaw agents add coding — workspace と ~/.openclaw/agents/coding/ が作成されます。
ステップ 3 — agent と bindings の一覧
openclaw agents list --bindings — 各 agentId に固有の agentDir があることを確認します。
ステップ 4 — チャネルアカウント接続（例：WhatsApp）
openclaw channels login --channel whatsapp --account work — Gateway 起動前に各アカウントをリンクします。
ステップ 5 — openclaw.json の bindings 編集
agents.list とルートルールを追加します。peer 固有ルールは accountId: "*" より上に置きます。
ステップ 6 — Gateway 再起動とプローブ
openclaw gateway restart、openclaw channels status --probe — 各アカウントでテスト送信し、セッションが分離されていることを確認します。
ステップ 7（任意）— チャネル別モデル
WhatsApp に軽量モデル、Telegram に大型モデルなど、agent ごとに model: を独立設定できます。
マルチエージェント編成パターン
ルーティング（Gateway 内蔵）：どの agent がこのメッセージを処理するか。編成：複数 agent が 1 つの目標でどう協力するか。
パターン A — ネイティブルーティングのみ（まず推奨）
| シナリオ | binding 戦略 |
|---|---|
| 仕事用 / 個人用 WhatsApp | 異なる accountId → 異なる agentId |
| 1 DM で深いモデル | peer.kind: "direct" + E.164 をチャネルルールより上に |
| Discord コーディングチャンネル | guildId + channel id → coding |
| メンション付き家族グループ | 専用 agent + groupChat.mentionPatterns |
パターン B — agent 間委譲
tools.agentToAgent を明示的 allowlist で有効化。コーディネーター agent が調査やコーディングを別 agent に渡せます。
パターン C — 外部オーケストレータープラグイン
| プロジェクト | スタイル | 向いている用途 |
|---|---|---|
| openclaw-orchestrator | 適応型 LLM プランナー + ダッシュボード | オープンエンドな目標 |
| openclaw-orchestrator（ビジュアル） | ドラッグ＆ドロップ、承認ノード | コンプライアンス重視のフロー |
| open-claw-code | 階層型コーディング agent | マルチリポエンジニアリング |
これらは Gateway bindings を置き換えません。ルーティング後のセッション上で agent を調整します。
- WhatsApp / Discord の身元分離だけ → パターン A
- 1 ユーザーが多段階プロジェクト → パターン B または C
- IDE 中心の TDD → Obra Superpowers と併用
セキュリティ：エージェント別 sandbox と tools
信頼できない agent（家族グループ bot など）は sandbox + deny リストを使います。tools.elevated はグローバルで送信者ベースです。ハード境界には agent ごとに exec を deny します。
Gateway の実行場所
OpenClaw はローカルファースト（macOS、Linux、WSL2 の Windows）です。チャネル webhook とセッション継続のため Gateway は常時オンが望ましいです。
チームではノート PC の代わりに24 時間稼働の専用 Macで動かすことがあります。東京リージョンなど低遅延ノードを使う場合も、セキュリティ要件に合うホストを選んでください。リモート管理の基礎は Mac mini M4 SSH ガイド を参照してください。
トラブルシューティング
誤った agent が応答する
openclaw agents list --bindings でルール順（peer 優先）と accountId キーの一致を確認 → openclaw gateway restart。
auth / セッションの混線
各 agentId に固有の agentDir があるか確認。共有していたら openclaw channels login --channel whatsapp --account work で再ログイン。
Gateway は起動するがプローブ失敗
認証情報の再リンク、webhook 用ファイアウォール、Discord / Telegram のトークン設定を チャネルガイド に沿って確認します。
FAQ
agentId を割り当てられます。真の分離には人数分の agent が必要です。enabled: true と厳しい allow リストがある場合のみ。既定は false です。~/.openclaw/skills、Claude Code は /plugin install。Understand Anything など一部は install.sh openclaw ブリッジがあります。まとめ
OpenClaw マルチエージェント編成は Gateway から始まります。1 プロセス、多数の分離 agent、チャネルから頭脳への決定論的 bindings。openclaw agents add で agents.list と bindings を配線し、再起動とプローブのあと、必要なら agent-to-agent や外部オーケストレーターを重ねてください。