廣播群組

概覽

廣播群組會針對同一則傳入訊息執行多個代理程式。每個代理程式都會在自己隔離的工作階段中處理訊息，並各自發布回覆，因此一個 WhatsApp 號碼可在單一群組聊天或私訊中容納一組專業化代理程式團隊。

廣播群組會在頻道允許清單和群組啟用規則之後進行評估。在 WhatsApp 群組中，當 OpenClaw 通常會回覆時（例如：有人提及時，取決於你的群組設定）就會進行廣播。它們只會改變要執行哪些代理程式，絕不會改變訊息是否符合處理資格。

即時 WhatsApp QA 流程包含 whatsapp-broadcast-group-fanout，用來驗證一則有提及對象的群組訊息，能否從兩個已設定的代理程式產生不同且可見的回覆。

設定

基本設定

新增頂層 broadcast 區段（與 bindings 同層）。鍵是 WhatsApp 對等端 ID，值是代理程式 ID 陣列：

• 群組聊天：群組 JID（例如 120363403215116621@g.us）
• 私訊：傳送者的 E.164 電話號碼（例如 +15551234567）

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

結果： 當 OpenClaw 會在此聊天中回覆時，它會執行全部三個代理程式。

列出的每個代理程式 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 等）

有一項刻意共用的例外：群組上下文緩衝區（用作上下文的近期群組訊息）會由每個對等端共用，因此觸發時，所有廣播代理程式都會看到相同的上下文。分派完成後，它會統一清除一次。

如此一來，每個代理程式都能擁有不同的個性、模型、技能和工具存取權（例如唯讀與讀寫）。

範例：隔離的工作階段

在具有代理程式 ["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 使用各自的語言回覆。
• 品質保證：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（網頁頻道）實作。其他頻道會忽略 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. **速率限制：**所有回覆都來自同一個 WhatsApp 帳號，因此每個代理程式的回覆都會計入相同的 WhatsApp 速率限制。

相關內容

• 頻道路由
• 群組
• 多代理程式沙箱工具
• 配對
• 工作階段管理