English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Configuration

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

Status: experimental

概要

ブロードキャストグループを使うと、複数のエージェントが同じメッセージを同時に処理して応答できます。これにより、単一の WhatsApp グループまたは DM 内で連携する専門エージェントチームを、1つの電話番号だけで作成できます。

現在の対象範囲: WhatsApp のみ（Web チャネル）。

ブロードキャストグループは、チャネルの許可リストとグループ有効化ルールの後に評価されます。WhatsApp グループでは、これは OpenClaw が通常応答する場合にブロードキャストが発生することを意味します（例: グループ設定に応じたメンション時）。

ライブ WhatsApp QA レーンには whatsapp-broadcast-group-fanout が含まれており、メンションされた1件のグループメッセージから、設定済みの2つのエージェントがそれぞれ異なる可視応答を生成できることを検証します。

ユースケース

1. 専門エージェントチーム

原子的で焦点を絞った責任を持つ複数のエージェントをデプロイします。

Code
Group: "Development Team"Agents:  - CodeReviewer (reviews code snippets)  - DocumentationBot (generates docs)  - SecurityAuditor (checks for vulnerabilities)  - TestGenerator (suggests test cases)

各エージェントは同じメッセージを処理し、それぞれの専門的な観点を提供します。

2. 多言語サポート
Code
Group: "International Support"Agents:  - Agent_EN (responds in English)  - Agent_DE (responds in German)  - Agent_ES (responds in Spanish)
3. 品質保証ワークフロー
Code
Group: "Customer Support"Agents:  - SupportAgent (provides answer)  - QAAgent (reviews quality, only responds if issues found)
4. タスク自動化
Code
Group: "Project Management"Agents:  - TaskTracker (updates task database)  - TimeLogger (logs time spent)  - ReportGenerator (creates summaries)

設定

基本セットアップ

トップレベルの broadcast セクションを（bindings の隣に）追加します。キーは WhatsApp ピア ID です。

  • グループチャット: グループ JID（例: 120363403215116621@g.us）
  • DM: E.164 電話番号（例: +15551234567）
json
{  "broadcast": {    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]  }}

結果: OpenClaw がこのチャットで応答する場合、3つすべてのエージェントを実行します。

処理戦略

エージェントがメッセージを処理する方法を制御します。

parallel（デフォルト）

すべてのエージェントが同時に処理します。

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

sequential

エージェントは順番に処理します（1つ前の完了を待ちます）。

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

完全な例

json
{  "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"]  }}

仕組み

メッセージフロー

  • 受信メッセージが到着

    WhatsApp グループまたは DM メッセージが到着します。

  • ルートと受け入れ

    OpenClaw はチャネル許可リスト、グループ有効化ルール、設定済みの ACP バインディング所有権を適用します。

  • ブロードキャスト確認

    設定済みの ACP バインディングがルートを所有していない場合、OpenClaw はピア ID が broadcast に含まれているかを確認します。

  • ブロードキャストが適用される場合

    • リストされたすべてのエージェントがメッセージを処理します。
    • 各エージェントは独自のセッションキーと隔離されたコンテキストを持ちます。
    • エージェントは並列（デフォルト）または順次に処理します。

  • ブロードキャストが適用されない場合

    OpenClaw は通常のルート、またはルーティング中に選択された設定済み ACP セッションルートへディスパッチします。

    • セッションの隔離

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

    • セッションキー（agent:alfred:whatsapp:group:120363... と agent:baerbel:whatsapp:group:120363...）
    • 会話履歴（エージェントは他のエージェントのメッセージを見ません）
    • ワークスペース（設定されている場合は別々のサンドボックス）
    • ツールアクセス（異なる許可/拒否リスト）
    • メモリ/コンテキスト（別々の IDENTITY.md、SOUL.md など）
    • グループコンテキストバッファ（コンテキストに使われる最近のグループメッセージ）はピアごとに共有されるため、トリガー時にはすべてのブロードキャストエージェントが同じコンテキストを参照します

    これにより、各エージェントは以下を持てます。

    • 異なるパーソナリティ
    • 異なるツールアクセス（例: 読み取り専用と読み書き）
    • 異なるモデル（例: opus と sonnet）
    • 異なる Skills のインストール

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

    グループ 120363403215116621@g.us にエージェント ["alfred", "baerbel"] がある場合:

    Alfred のコンテキスト

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

    Bärbel のコンテキスト

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

    ベストプラクティス

    1. エージェントの焦点を絞る

    各エージェントを、単一で明確な責任を持つように設計します。

    json
    {  "broadcast": {    "DEV_GROUP": ["formatter", "linter", "tester"]  }}

    ✅ 良い: 各エージェントに1つの役割がある。❌ 悪い: 汎用的な "dev-helper" エージェントが1つだけ。

    2. 説明的な名前を使う

    各エージェントの役割が明確になるようにします。

    json
    {  "agents": {    "security-scanner": { "name": "Security Scanner" },    "code-formatter": { "name": "Code Formatter" },    "test-generator": { "name": "Test Generator" }  }}
    3. 異なるツールアクセスを設定する

    エージェントには必要なツールだけを与えます。

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

    reviewer は読み取り専用です。fixer は読み取りと書き込みができます。

    4. パフォーマンスを監視する

    エージェントが多い場合は、以下を検討してください。

    • 速度のために "strategy": "parallel"（デフォルト）を使う
    • ブロードキャストグループを5〜10エージェントに制限する
    • より単純なエージェントには高速なモデルを使う
    5. 失敗を適切に処理する

    エージェントは独立して失敗します。あるエージェントのエラーが他をブロックすることはありません。

    Code
    Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]Result: Agent A and C respond, Agent B logs error

    互換性

    プロバイダー

    ブロードキャストグループは現在、以下で動作します。

    • ✅ WhatsApp（実装済み）
    • 🚧 Telegram（予定）
    • 🚧 Discord（予定）
    • 🚧 Slack（予定）

    ルーティング

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

    json
    {  "bindings": [    {      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },      "agentId": "alfred"    }  ],  "broadcast": {    "GROUP_B": ["agent1", "agent2"]  }}
    • GROUP_A: alfred だけが応答します（通常のルーティング）。
    • GROUP_B: agent1 と agent2 が応答します（ブロードキャスト）。

    トラブルシューティング

    エージェントが応答しない

    確認:

    1. エージェント ID が agents.list に存在する。
    2. ピア ID 形式が正しい（例: 120363403215116621@g.us）。
    3. エージェントが拒否リストに含まれていない。

    デバッグ:

    bash
    tail -f ~/.openclaw/logs/gateway.log | grep broadcast
    1つのエージェントだけが応答する

    原因: ピア ID が通常のルートバインディングには含まれているが broadcast には含まれていない、または排他的な設定済み ACP バインディングに一致している可能性があります。

    修正: 通常のルートにバインドされたピアをブロードキャスト設定に追加するか、ファンアウトブロードキャストが必要な場合は設定済み ACP バインディングを削除または変更します。

    パフォーマンスの問題

    多数のエージェントで遅い場合:

    • グループあたりのエージェント数を減らす。
    • より軽量なモデルを使う（opus ではなく sonnet）。
    • サンドボックスの起動時間を確認する。

    例

    例 1: コードレビューチーム
    json
    {  "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"] } }    ]  }}

    ユーザーが送信: コードスニペット。

    応答:

    • code-formatter: "Fixed indentation and added type hints"
    • security-scanner: "⚠️ SQL injection vulnerability in line 12"
    • test-coverage: "Coverage is 45%, missing tests for error cases"
    • docs-checker: "Missing docstring for function process_data"
    例 2: 多言語サポート
    json
    {  "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 リファレンス

    設定スキーマ

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

    フィールド

    strategy"parallel" | "sequential"default: "parallel"

    エージェントの処理方法。parallel はすべてのエージェントを同時に実行し、sequential は配列の順序で実行します。

    [peerId]string[]

    WhatsApp グループ JID、E.164 番号、またはその他のピア ID。値は、メッセージを処理するエージェント ID の配列です。

    制限事項

    1. 最大エージェント数: ハードリミットはありませんが、10 個以上のエージェントでは遅くなる場合があります。
    2. 共有コンテキスト: エージェントは互いの応答を参照しません（設計上の仕様です）。
    3. メッセージ順序: 並列応答は任意の順序で到着する場合があります。
    4. レート制限: すべてのエージェントが WhatsApp のレート制限にカウントされます。

    今後の拡張

    計画中の機能:

    • [ ] 共有コンテキストモード（エージェントが互いの応答を参照できる）
    • [ ] エージェント調整（エージェント同士がシグナルを送れる）
    • [ ] 動的なエージェント選択（メッセージ内容に基づいてエージェントを選択）
    • [ ] エージェント優先度（一部のエージェントが他より先に応答）

    関連

    Was this useful?
    On this page

    On this page