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

概要

ブロードキャストグループでは、同じ受信メッセージに対して複数のエージェントが実行されます。各エージェントは独自の分離されたセッションでメッセージを処理し、それぞれが返信を投稿するため、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.entries に存在する必要があります。設定の検証では不明な ID が報告され、ランタイムは Broadcast agent <id> not found in agents.entries; 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 つあります。グループコンテキストバッファー（コンテキストとして使用される最近のグループメッセージ）はピア単位で共有されるため、トリガーされたすべてのブロードキャストエージェントに同じコンテキストが表示されます。ファンアウトの完了後に一度だけクリアされます。

これにより、各エージェントに異なるパーソナリティ、モデル、Skills、ツールアクセス（たとえば、読み取り専用と読み書き可能）を設定できます。

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

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

セッション: agent:alfred:whatsapp:group:120363403215116621@g.us履歴: [ユーザーメッセージ, Alfred の以前の応答]ワークスペース: ~/openclaw-alfred/ツール: 読み取り, 書き込み, 実行

セッション: agent:baerbel:whatsapp:group:120363403215116621@g.us履歴: [ユーザーメッセージ, Baerbel の以前の応答]ワークスペース: ~/openclaw-baerbel/ツール: 読み取り専用

ユースケース

• 特化型エージェントチーム: code-reviewer、security-auditor、test-generator、docs-checker が同じメッセージにそれぞれの観点から回答する開発グループ。
• 多言語サポート: support-en、support-de、support-es がそれぞれの言語で応答する 1 つのサポートチャット。
• 品質保証: 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 のレート制限にカウントされます。

関連項目

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