コンテンツにスキップ

Broadcast Groupsで複数のAIエージェントを連携させる方法

1つのAIエージェントにあらゆるタスクを詰め込もうとして、プロンプトが複雑になりすぎたり、期待した通りに動かなくなったりした経験はありませんか。複雑なワークフローを1つのエージェントだけで処理しようとすると、管理が難しくなり、精度も低下しがちです。

こうした課題を解決するのが Broadcast Groups です。これを使うと、1つのメッセージを複数の専門エージェントに同時に送信し、それぞれの視点から回答を得ることができます。開発チームや多言語サポートなど、役割を分担したエージェントチームを簡単に構築できます。

この機能を利用するには、以下の条件を満たしている必要があります。

  • OpenClaw Version 2026.1.9 以降
  • WhatsApp (web channel): 現在、この機能は WhatsApp のみに対応しています。

設定はとてもシンプルです。設定ファイルの bindings と同じ階層に broadcast セクションを追加し、対象となる WhatsApp の ID(Peer ID)と、実行したいエージェントのリストを指定します。

以下の例では、特定のグループチャットで3つのエージェントが同時に動くように設定しています。

{
"broadcast": {
"120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]
}
}

エージェントの実行順序を制御できます。

  • Parallel(デフォルト): すべてのエージェントが同時に処理を開始します。
  • Sequential: リストの順番通りに1つずつ処理します。
{
"broadcast": {
"strategy": "parallel",
"120363403215116621@g.us": ["alfred", "baerbel"]
}
}

Broadcast Groups がどのように動作するか、その仕組みを説明します。

  1. WhatsApp でメッセージを受信します。
  2. システムが broadcast 設定にその Peer ID が含まれているか確認します。
  3. リストにある場合、指定されたすべてのエージェントがメッセージを処理します。
  4. リストにない場合は、通常の bindings 設定に従ってルーティングされます。

各エージェントは完全に独立した状態で動作します。以下の要素はエージェントごとに分離されています。

  • Session keys: 各エージェントが独自のセッションを持ちます。
  • Conversation history: 他のエージェントの回答内容は参照しません。
  • Workspace / Tools: エージェントごとに異なる Sandbox やツール権限を設定できます。
  • Memory: IDENTITY.md や SOUL.md も個別に管理されます。

Broadcast Groups を効果的に使うためのポイントです。

  • エージェントの役割を絞る: 「コードレビュー担当」「ドキュメント作成担当」のように、1つのエージェントに1つの責任を持たせます。
  • 分かりやすい名前を付ける: security-scanner や test-generator など、役割がすぐ分かる ID を使用します。
  • ツール権限を最小限にする: 読み取り専用で十分なエージェントには、書き込み権限を与えないように設定します。
  • パフォーマンスを意識する: エージェントが多い場合は、parallel 戦略を使ったり、軽量なモデルを選択したりして速度を調整します。

設定したエージェントが動かない場合は、以下の項目を確認してください。

  • agents.list 内に指定したエージェント ID が正しく存在するか。
  • Peer ID の形式(例: 120363403215116621@g.us)が正しいか。
  • エージェントが deny リストに入っていないか。

ログを確認するには以下のコマンドを実行します。

Terminal window
tail -f ~/.openclaw/logs/gateway.log | grep broadcast

1つのエージェントしか応答しない

Section titled “1つのエージェントしか応答しない”
  • Peer ID が broadcast ではなく bindings にのみ設定されていないか確認してください。broadcast 設定に追加することで、複数エージェントが起動するようになります。

導入方法や設定に迷った場合は、AI Setup Assistant がお手伝いします。

OpenClaw

OpenClaw Expert

まだ解決しませんか?

このページで解決しない場合は、OpenClaw Expertに直接質問してください。