メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

ステータス: 実験的。2026.1.9 で追加。

​
概要

ブロードキャストグループを使うと、複数のエージェントが同じメッセージを同時に処理し、応答できます。これにより、1 つの WhatsApp グループまたは DM 内で連携する専用エージェントチームを、1 つの電話番号だけで作成できます。 現在のスコープ: WhatsApp のみ（Web チャネル）。 ブロードキャストグループは、チャネルの許可リストとグループ有効化ルールの後に評価されます。WhatsApp グループでは、これは OpenClaw が通常応答する場合にブロードキャストが発生することを意味します（例: グループ設定に応じたメンション時など）。

​
ユースケース

原子的で集中的な責務を持つ複数のエージェントをデプロイします。
Group: "Development Team"
Agents:
  - CodeReviewer (reviews code snippets)
  - DocumentationBot (generates docs)
  - SecurityAuditor (checks for vulnerabilities)
  - TestGenerator (suggests test cases)
各エージェントは同じメッセージを処理し、それぞれの専門的な観点を提供します。
Group: "International Support"
Agents:
  - Agent_EN (responds in English)
  - Agent_DE (responds in German)
  - Agent_ES (responds in Spanish)

Group: "Customer Support"
Agents:
  - SupportAgent (provides answer)
  - QAAgent (reviews quality, only responds if issues found)

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）
{
  "broadcast": {
    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]
  }
}
結果: OpenClaw がこのチャットで応答する場合、3 つすべてのエージェントを実行します。

​
処理戦略

エージェントがメッセージを処理する方法を制御します。
すべてのエージェントが同時に処理します。
{
  "broadcast": {
    "strategy": "parallel",
    "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"]
  }
}

​
仕組み

​
メッセージフロー

1

受信メッセージが到着

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

ブロードキャスト確認

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

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

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

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

通常のルーティングが適用されます（最初に一致したバインディング）。
ブロードキャストグループは、チャネルの許可リストやグループ有効化ルール（メンション/コマンドなど）をバイパスしません。メッセージが処理対象になったときに、どのエージェントを実行するか だけを変更します。

​
セッション分離

ブロードキャストグループ内の各エージェントは、次を完全に分離して保持します。
  • セッションキー（agent:alfred:whatsapp:group:120363... と agent:baerbel:whatsapp:group:120363...）
  • 会話履歴（エージェントは他のエージェントのメッセージを見ません）
  • ワークスペース（設定されている場合は別々のサンドボックス）
  • ツールアクセス（異なる許可/拒否リスト）
  • メモリ/コンテキスト（別々の IDENTITY.md、SOUL.md など）
  • グループコンテキストバッファ（コンテキストに使われる最近のグループメッセージ）はピアごとに共有されるため、すべてのブロードキャストエージェントはトリガー時に同じコンテキストを見ます
これにより、各エージェントに次を持たせることができます。
  • 異なるパーソナリティ
  • 異なるツールアクセス（例: 読み取り専用と読み書き）
  • 異なるモデル（例: opus と sonnet）
  • 異なる Skills のインストール

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

エージェント ["alfred", "baerbel"] を持つグループ 120363403215116621@g.us の場合: 
Session: agent:alfred:whatsapp:group:120363403215116621@g.us
History: [user message, alfred's previous responses]
Workspace: /Users/user/openclaw-alfred/
Tools: read, write, exec

​
ベストプラクティス

各エージェントは、単一で明確な責務を持つように設計します。
{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}
✅ 良い例: 各エージェントが 1 つの役割を持つ。❌ 悪い例: 汎用的な “dev-helper” エージェント 1 つ。
各エージェントが何をするのか明確にします。
{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}
エージェントには必要なツールだけを付与します。
{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] }
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] }
    }
  }
}
reviewer は読み取り専用です。fixer は読み取りと書き込みができます。
エージェントが多い場合は、次を検討します。
  • 速度のために "strategy": "parallel"（デフォルト）を使う
  • ブロードキャストグループを 5〜10 エージェントに制限する
  • より単純なエージェントには高速なモデルを使う
エージェントは独立して失敗します。1 つのエージェントのエラーが他をブロックすることはありません。
Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]
Result: Agent A and C respond, Agent B logs error

​
互換性

​
プロバイダー

ブロードキャストグループは現在、次で動作します。
  • ✅ WhatsApp（実装済み）
  • 🚧 Telegram（予定）
  • 🚧 Discord（予定）
  • 🚧 Slack（予定）

​
ルーティング

ブロードキャストグループは既存のルーティングと併用できます。 
{
  "bindings": [
    {
      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },
      "agentId": "alfred"
    }
  ],
  "broadcast": {
    "GROUP_B": ["agent1", "agent2"]
  }
}
  • GROUP_A: alfred のみが応答します（通常のルーティング）。
  • GROUP_B: agent1 と agent2 が応答します（ブロードキャスト）。
優先順位: broadcast は bindings より優先されます。

​
トラブルシューティング

確認:
  1. エージェント ID が agents.list に存在する。
  2. ピア ID の形式が正しい（例: 120363403215116621@g.us）。
  3. エージェントが拒否リストに入っていない。
デバッグ:
tail -f ~/.openclaw/logs/gateway.log | grep broadcast
原因: ピア ID が bindings に含まれているが、broadcast には含まれていない可能性があります。修正: ブロードキャスト設定に追加するか、バインディングから削除します。
エージェントが多くて遅い場合:
  • グループあたりのエージェント数を減らします。
  • 軽量なモデルを使います（opus ではなく sonnet）。
  • サンドボックスの起動時間を確認します。

​
例

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

​
フィールド

​
strategy
"parallel" | "sequential"
デフォルト:"\"parallel\""
エージェントを処理する方法です。parallel はすべてのエージェントを同時に実行し、sequential は配列の順序で実行します。
​
[peerId]
string[]
WhatsApp グループ JID、E.164 番号、またはその他のピア ID。値は、メッセージを処理するエージェント ID の配列です。

​
制限事項

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

​
今後の拡張

予定されている機能:
  • 共有コンテキストモード（エージェントが互いの応答を見る）
  • エージェントの調整（エージェントが互いにシグナルを送れる）
  • 動的なエージェント選択（メッセージ内容に基づいてエージェントを選ぶ）
  • エージェントの優先度（一部のエージェントが他より先に応答する）

​
関連