Broadcast Groups

状态： 实验性
版本： 添加于 2026.1.9

概述

广播群组使多个代理能够同时处理和响应同一条消息。这让你可以创建专门的代理团队，在单个 WhatsApp 群组或 DM 中一起工作 — 都使用一个电话号码。

当前范围：仅限 WhatsApp（web 渠道）。

广播群组在渠道白名单和群组激活规则之后进行评估。在 WhatsApp 群组中，这意味着当 OpenClaw 通常会回复时发生广播（例如：在提及后，取决于你的群组设置）。

用例

1. 专门的代理团队

部署多个具有原子化、专注职责的代理：

群组："Development Team"
代理：
  - CodeReviewer（审查代码片段）
  - DocumentationBot（生成文档）
  - SecurityAuditor（检查漏洞）
  - TestGenerator（建议测试用例）

每个代理处理相同的消息并提供其专门的视角。

2. 多语言支持

群组："International Support"
代理：
  - Agent_EN（用英语回复）
  - Agent_DE（用德语回复）
  - Agent_ES（用西班牙语回复）

3. 质量保证工作流

群组："Customer Support"
代理：
  - SupportAgent（提供答案）
  - QAAgent（审查质量，仅在发现问题时回复）

4. 任务自动化

群组："Project Management"
代理：
  - TaskTracker（更新任务数据库）
  - TimeLogger（记录花费的时间）
  - ReportGenerator（创建摘要）

配置

基本设置

添加顶级 broadcast 部分（在 bindings 旁边）。键是 WhatsApp 对等 ID：

群组聊天：群组 JID（例如 120363403215116621@g.us）
DM：E.164 电话号码（例如 +15551234567）

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

结果： 当 OpenClaw 在此聊天中回复时，它将运行所有三个代理。

处理策略

控制代理如何处理消息：

并行（默认）

所有代理同时处理：

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

顺序

代理按顺序处理（一个等待前一个完成）：

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

工作原理

消息流

传入消息到达 WhatsApp 群组
广播检查：系统检查对等 ID 是否在 broadcast 中
如果在广播列表中：
- 所有列出的代理处理消息
- 每个代理有自己的会话键和隔离的上下文
- 代理并行处理（默认）或顺序处理
如果不在广播列表中：
- 应用正常路由（第一个匹配的绑定）

注意：广播群组不绕过渠道白名单或群组激活规则（提及/命令等）。它们只改变_当消息符合处理条件时运行哪些代理_。

会话隔离

广播群组中的每个代理保持完全独立的：

会话键（agent:alfred:whatsapp:group:120363... vs agent:baerbel:whatsapp:group:120363...）
对话历史（代理看不到其他代理的消息）
工作区（如果配置则单独的沙盒）
工具访问（不同的允许/拒绝列表）
内存/上下文（单独的 IDENTITY.md、SOUL.md 等）
群组上下文缓冲区（用于上下文的最近群组消息）每个对等共享，因此所有广播代理在触发时看到相同的上下文

这允许每个代理拥有：

不同的个性
不同的工具访问（例如只读 vs 读写）
不同的模型（例如 opus vs sonnet）
不同的技能安装

示例：隔离的会话

在群组 120363403215116621@g.us 中有代理 ["alfred", "baerbel"]：

Alfred 的上下文：

会话：agent:alfred:whatsapp:group:120363403215116621@g.us
历史：[用户消息，alfred 之前的回复]
工作区：/Users/pascal/openclaw-alfred/
工具：read, write, exec

Bärbel 的上下文：

会话：agent:baerbel:whatsapp:group:120363403215116621@g.us
历史：[用户消息，baerbel 之前的回复]
工作区：/Users/pascal/openclaw-baerbel/
工具：只读

最佳实践

1. 保持代理专注

设计每个代理具有单一、清晰的职责：

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

✅ 好：每个代理有一项工作
❌ 坏：一个通用的 "dev-helper" 代理

2. 使用描述性名称

清楚说明每个代理做什么：

{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}

3. 配置不同的工具访问

只给代理他们需要的工具：

{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] } // 只读
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] } // 读写
    }
  }
}

4. 监控性能

使用多个代理时，考虑：

使用 "strategy": "parallel"（默认）以获得速度
将广播群组限制为 5-10 个代理
为简单代理使用更快的模型

5. 优雅地处理故障

代理独立失败。一个代理的错误不会阻止其他代理：

消息 → [代理 A ✓，代理 B ✗ 错误，代理 C ✓]
结果：代理 A 和 C 回复，代理 B 记录错误

兼容性

提供商

广播群组当前适用于：

✅ 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。

故障排除

代理未回复

检查：

代理 ID 存在于 agents.list 中
对等 ID 格式正确（例如 120363403215116621@g.us）
代理不在拒绝列表中

调试：

tail -f ~/.openclaw/logs/gateway.log | grep broadcast

只有一个代理回复

原因： 对等 ID 可能在 bindings 中但不在 broadcast 中。

修复： 添加到广播配置或从 bindings 中移除。

性能问题

如果多个代理很慢：

减少每个群组的代理数量
使用更轻量的模型（sonnet 而不是 opus）
检查沙盒启动时间

示例

示例 1：代码审查团队

{
  "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 缺少文档字符串"

示例 2：多语言支持

{
  "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"：代理按数组顺序处理
[peerId]：WhatsApp 群组 JID、E.164 号码或其他对等 ID
- 值：应处理消息的代理 ID 数组

限制

最大代理数： 无硬性限制，但 10+ 代理可能很慢
共享上下文： 代理看不到彼此的回复（设计如此）
消息顺序： 并行回复可能以任何顺序到达
速率限制： 所有代理都计入 WhatsApp 速率限制

未来增强

计划功能：

共享上下文模式（代理可以看到彼此的回复）
代理协调（代理可以相互信号）
动态代理选择（根据消息内容选择代理）
代理优先级（一些代理在其他代理之前回复）

Broadcast Groups

Broadcast Groups

概述

用例

1. 专门的代理团队

2. 多语言支持

3. 质量保证工作流

4. 任务自动化

配置

基本设置

处理策略

并行（默认）

顺序

完整示例

工作原理

消息流

会话隔离

示例：隔离的会话

最佳实践

1. 保持代理专注

2. 使用描述性名称

3. 配置不同的工具访问

4. 监控性能

5. 优雅地处理故障

兼容性

提供商

路由

故障排除

代理未回复

只有一个代理回复

性能问题

示例

示例 1：代码审查团队

示例 2：多语言支持

API 参考

配置模式

字段

限制

未来增强

另请参阅