Broadcast Groupsで複数のAIエージェントを連携させる方法
1つのAIエージェントにあらゆるタスクを詰め込もうとして、プロンプトが複雑になりすぎたり、期待した通りに動かなくなったりした経験はありませんか。複雑なワークフローを1つのエージェントだけで処理しようとすると、管理が難しくなり、精度も低下しがちです。
こうした課題を解決するのが Broadcast Groups です。これを使うと、1つのメッセージを複数の専門エージェントに同時に送信し、それぞれの視点から回答を得ることができます。開発チームや多言語サポートなど、役割を分担したエージェントチームを簡単に構築できます。
この機能を利用するには、以下の条件を満たしている必要があります。
- OpenClaw Version 2026.1.9 以降
- WhatsApp (web channel): 現在、この機能は WhatsApp のみに対応しています。
クイックスタート
Section titled “クイックスタート”設定はとてもシンプルです。設定ファイルの bindings と同じ階層に broadcast セクションを追加し、対象となる WhatsApp の ID(Peer ID)と、実行したいエージェントのリストを指定します。
1. 基本設定
Section titled “1. 基本設定”以下の例では、特定のグループチャットで3つのエージェントが同時に動くように設定しています。
{ "broadcast": { "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"] }}2. 処理戦略(Strategy)の選択
Section titled “2. 処理戦略(Strategy)の選択”エージェントの実行順序を制御できます。
- Parallel(デフォルト): すべてのエージェントが同時に処理を開始します。
- Sequential: リストの順番通りに1つずつ処理します。
{ "broadcast": { "strategy": "parallel", "120363403215116621@g.us": ["alfred", "baerbel"] }}How It Works
Section titled “How It Works”Broadcast Groups がどのように動作するか、その仕組みを説明します。
メッセージの流れ
Section titled “メッセージの流れ”- WhatsApp でメッセージを受信します。
- システムが
broadcast設定にその Peer ID が含まれているか確認します。 - リストにある場合、指定されたすべてのエージェントがメッセージを処理します。
- リストにない場合は、通常の
bindings設定に従ってルーティングされます。
セッションの独立性
Section titled “セッションの独立性”各エージェントは完全に独立した状態で動作します。以下の要素はエージェントごとに分離されています。
- Session keys: 各エージェントが独自のセッションを持ちます。
- Conversation history: 他のエージェントの回答内容は参照しません。
- Workspace / Tools: エージェントごとに異なる Sandbox やツール権限を設定できます。
- Memory: IDENTITY.md や SOUL.md も個別に管理されます。
Best Practices
Section titled “Best Practices”Broadcast Groups を効果的に使うためのポイントです。
- エージェントの役割を絞る: 「コードレビュー担当」「ドキュメント作成担当」のように、1つのエージェントに1つの責任を持たせます。
- 分かりやすい名前を付ける:
security-scannerやtest-generatorなど、役割がすぐ分かる ID を使用します。 - ツール権限を最小限にする: 読み取り専用で十分なエージェントには、書き込み権限を与えないように設定します。
- パフォーマンスを意識する: エージェントが多い場合は、
parallel戦略を使ったり、軽量なモデルを選択したりして速度を調整します。
トラブルシューティング
Section titled “トラブルシューティング”設定したエージェントが動かない場合は、以下の項目を確認してください。
エージェントが応答しない
Section titled “エージェントが応答しない”agents.list内に指定したエージェント ID が正しく存在するか。- Peer ID の形式(例:
120363403215116621@g.us)が正しいか。 - エージェントが
denyリストに入っていないか。
ログを確認するには以下のコマンドを実行します。
tail -f ~/.openclaw/logs/gateway.log | grep broadcast1つのエージェントしか応答しない
Section titled “1つのエージェントしか応答しない”- Peer ID が
broadcastではなくbindingsにのみ設定されていないか確認してください。broadcast設定に追加することで、複数エージェントが起動するようになります。
導入方法や設定に迷った場合は、AI Setup Assistant がお手伝いします。
次のステップ
Section titled “次のステップ”OpenClaw Expert
まだ解決しませんか?
このページで解決しない場合は、OpenClaw Expertに直接質問してください。