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

概要

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

現在のスコープ: WhatsApp のみ（Web チャネル）。

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

ユースケース

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（例: [email protected]）
  • DM: E.164 電話番号（例: +15551234567）
json
{  "broadcast": {    "[email protected]": ["alfred", "baerbel", "assistant3"]  }}

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

処理戦略

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

parallel（デフォルト）

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

json
{  "broadcast": {    "strategy": "parallel",    "[email protected]": ["alfred", "baerbel"]  }}

sequential

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

json
{  "broadcast": {    "strategy": "sequential",    "[email protected]": ["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",    "[email protected]": ["code-reviewer", "security-auditor", "docs-generator"],    "[email protected]": ["support-en", "support-de"],    "+15555550123": ["assistant", "logger"]  }}

仕組み

メッセージフロー

  • 受信メッセージが到着

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

  • ブロードキャスト確認

    システムはピア ID が broadcast に含まれているかを確認します。

  • ブロードキャストリストに含まれる場合

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

  • ブロードキャストリストに含まれない場合

    通常のルーティングが適用されます（最初に一致したバインディング）。

    • セッション分離

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

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

    これにより、各エージェントに次を持たせることができます。

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

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

    エージェント ["alfred", "baerbel"] を持つグループ [email protected] の場合:

    Alfred のコンテキスト

    Code
    Session: agent:alfred:whatsapp:group:[email protected]History: [user message, alfred's previous responses]Workspace: /Users/user/openclaw-alfred/Tools: read, write, exec

    Bärbel のコンテキスト

    Code
    Session: agent:baerbel:whatsapp:group:[email protected]History: [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. 失敗を適切に処理する

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

    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 の形式が正しい（例: [email protected]）。
    3. エージェントが拒否リストに入っていない。

    デバッグ:

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

    原因: ピア ID が bindings に含まれているが、broadcast には含まれていない可能性があります。

    修正: ブロードキャスト設定に追加するか、バインディングから削除します。

    パフォーマンスの問題

    エージェントが多くて遅い場合:

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

    例

    例 1: コードレビューチーム
    json
    {  "broadcast": {    "strategy": "parallel",    "[email protected]": [      "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: 「インデントを修正し、型ヒントを追加しました」
    • security-scanner: 「⚠️ 12 行目に SQL インジェクション脆弱性があります」
    • test-coverage: 「カバレッジは 45% で、エラーケースのテストが不足しています」
    • docs-checker: 「関数 process_data の docstring がありません」
    例 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?