ブロードキャストグループ

概要

ブロードキャストグループは、同じ受信メッセージに対して複数のエージェントを実行します。各エージェントはそれぞれ独立したセッションでメッセージを処理し、個別に返信を投稿します。そのため、1 つの WhatsApp 番号で、単一のグループチャットまたは DM 内に専門エージェントのチームを構成できます。

ブロードキャストグループは、チャネルの許可リストとグループのアクティベーションルールの適用後に評価されます。WhatsApp グループでは、通常なら OpenClaw が返信する場合（たとえば、グループ設定に応じてメンションされた場合）にブロードキャストが行われます。変更されるのはどのエージェントが実行されるかだけであり、メッセージが処理対象になるかどうかは変わりません。

稼働中の WhatsApp QA レーンには whatsapp-broadcast-group-fanout が含まれており、メンションを含む 1 件のグループメッセージから、設定された 2 つのエージェントによる別々の返信が表示されることを検証します。

設定

基本設定

トップレベルに broadcast セクションを追加します（bindings と同じ階層）。キーは WhatsApp のピア ID、値はエージェント ID の配列です。

• グループチャット: グループ JID（例: 120363403215116621@g.us）
• DM: 送信者の E.164 電話番号（例: +15551234567）

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

結果: このチャットで通常なら OpenClaw が返信する場合、3 つのエージェントがすべて実行されます。

指定するすべてのエージェント ID は agents.list に存在する必要があります。設定検証で不明な ID が報告され、実行時には Broadcast agent <id> not found in agents.list; skipping という警告とともにスキップされます。

処理戦略

broadcast.strategy は、エージェントがメッセージを処理する方法を設定します。

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

完全な例

{  "agents": {    "list": [      {        "id": "code-reviewer",        "name": "Code Reviewer",        "workspace": "/path/to/code-reviewer",        "sandbox": { "mode": "all" }      },      {        "id": "security-auditor",        "name": "Security Auditor",        "workspace": "/path/to/security-auditor",        "sandbox": { "mode": "all" }      },      {        "id": "docs-generator",        "name": "Documentation Generator",        "workspace": "/path/to/docs-generator",        "sandbox": { "mode": "all" }      }    ]  },  "broadcast": {    "strategy": "parallel",    "120363403215116621@g.us": ["code-reviewer", "security-auditor", "docs-generator"],    "120363424282127706@g.us": ["support-en", "support-de"],    "+15555550123": ["assistant", "logger"]  }}

仕組み

メッセージフロー

セッションの分離

ブロードキャストグループ内の各エージェントは、以下を完全に分離して保持します。

• セッションキー（agent:alfred:whatsapp:group:120363... と agent:baerbel:whatsapp:group:120363...）
• 会話履歴（エージェントは他のエージェントの返信を参照しません）
• ワークスペース（設定されている場合は個別のサンドボックス）
• ツールアクセス（異なる許可リストと拒否リスト）
• メモリ／コンテキスト（個別の IDENTITY.md、SOUL.md など）

意図的に共有される例外が 1 つあります。グループコンテキストバッファー（コンテキストに使用する最近のグループメッセージ）はピアごとに共有されるため、トリガーされたすべてのブロードキャストエージェントが同じコンテキストを参照します。ファンアウトの完了後に一度だけクリアされます。

これにより、エージェントごとに異なる人格、モデル、スキル、ツールアクセス（たとえば読み取り専用と読み書き可能）を設定できます。

例: 分離されたセッション

エージェント ["alfred", "baerbel"] を持つグループ 120363403215116621@g.us の場合:

Session: agent:alfred:whatsapp:group:120363403215116621@g.usHistory: [user message, alfred's previous responses]Workspace: ~/openclaw-alfred/Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:120363403215116621@g.usHistory: [user message, baerbel's previous responses]Workspace: ~/openclaw-baerbel/Tools: read only

ユースケース

• 専門エージェントチーム: code-reviewer、security-auditor、test-generator、docs-checker が、それぞれ独自の観点から同じメッセージに回答する開発グループ。
• 多言語サポート: support-en、support-de、support-es がそれぞれの言語で応答する単一のサポートチャット。
• 品質保証: support-agent が回答し、qa-agent がレビューして問題を発見した場合にのみ応答します。
• タスク自動化: task-tracker、time-logger、report-generator がすべて同じステータス更新を処理します。

ベストプラクティス

{  "agents": {    "list": [      { "id": "security-scanner", "name": "Security Scanner" },      { "id": "code-formatter", "name": "Code Formatter" },      { "id": "test-generator", "name": "Test Generator" }    ]  }}

{  "agents": {    "list": [      { "id": "reviewer", "tools": { "allow": ["read", "exec"] } },      { "id": "fixer", "tools": { "allow": ["read", "write", "edit", "exec"] } }    ]  }}

互換性

プロバイダー

ブロードキャストグループは現在、WhatsApp（Web チャネル）でのみ実装されています。他のチャネルは broadcast 設定を無視します。

ルーティング

ブロードキャストグループは既存のルーティングと併用できます。

{  "bindings": [    {      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },      "agentId": "alfred"    }  ],  "broadcast": {    "GROUP_B": ["agent1", "agent2"]  }}

• GROUP_A: alfred のみが応答します（通常のルーティング）。
• GROUP_B: agent1 と agent2 の両方が応答します（ブロードキャスト）。

トラブルシューティング

openclaw logs --follow | grep -i broadcast

例

{  "broadcast": {    "strategy": "parallel",    "120363403215116621@g.us": [      "code-formatter",      "security-scanner",      "test-coverage",      "docs-checker"    ]  },  "agents": {    "list": [      {        "id": "code-formatter",        "workspace": "~/agents/formatter",        "tools": { "allow": ["read", "write"] }      },      {        "id": "security-scanner",        "workspace": "~/agents/security",        "tools": { "allow": ["read", "exec"] }      },      {        "id": "test-coverage",        "workspace": "~/agents/testing",        "tools": { "allow": ["read", "exec"] }      },      { "id": "docs-checker", "workspace": "~/agents/docs", "tools": { "allow": ["read"] } }    ]  }}

{  "broadcast": {    "strategy": "sequential",    "+15555550123": ["detect-language", "translator-en", "translator-de"]  },  "agents": {    "list": [      { "id": "detect-language", "workspace": "~/agents/lang-detect" },      { "id": "translator-en", "workspace": "~/agents/translate-en" },      { "id": "translator-de", "workspace": "~/agents/translate-de" }    ]  }}

API リファレンス

設定スキーマ

interface OpenClawConfig {  broadcast?: {    strategy?: "parallel" | "sequential";    [peerId: string]: string[];  };}

フィールド

制限事項

1. 最大エージェント数: ハードリミットはありませんが、多数のエージェント（10 以上）では処理が遅くなる可能性があります。
2. 共有コンテキスト: 設計上、エージェントは互いの応答を参照しません。
3. メッセージの順序: 並列処理の応答は任意の順序で届く可能性があります。
4. レート制限: すべての返信は 1 つの WhatsApp アカウントから送信されるため、各エージェントの返信は同じ WhatsApp のレート制限に算入されます。

関連項目

• チャネルルーティング
• グループ
• マルチエージェントサンドボックスツール
• ペアリング
• セッション管理