廣播群組

概覽

廣播群組會針對同一則傳入訊息執行多個代理程式。每個代理程式都會在各自隔離的工作階段中處理訊息並發布自己的回覆，因此一個 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.list 中：設定驗證會回報未知 ID，而執行階段會略過這些 ID，並顯示 Broadcast agent <id> not found in agents.list; 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 等）

有一項刻意共用的例外：群組情境緩衝區（用於提供情境的近期群組訊息）會依對等端共用，因此所有廣播代理程式在觸發時都會看到相同的情境。扇出完成後，此緩衝區會統一清除一次。

如此一來，每個代理程式都可以具備不同的個性、模型、Skills 與工具存取權（例如唯讀與讀寫）。

範例：隔離的工作階段

在群組 120363403215116621@g.us 中使用代理程式 ["alfred", "baerbel"]：

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

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

使用案例

• 專業化代理程式團隊：在開發群組中，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 速率限制。

相關內容

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