广播组
状态: 实验性版本: 在 2026.1.9 中添加
概述
广播组使多个代理能够同时处理和响应同一条消息。这使您能够创建专业的代理团队,在单个 WhatsApp 群组或私聊中协同工作——全部使用一个电话号码。 当前范围:仅限 WhatsApp(Web 通道)。 广播组在通道白名单和群组激活规则之后进行评估。在 WhatsApp 群组中,这意味着当 OpenClaw 通常会回复时(例如:被提及时,取决于您的群组设置)会发生广播。使用场景
1. 专业代理团队
部署具有原子化、专注职责的多个代理:2. 多语言支持
3. 质量保证工作流
4. 任务自动化
配置
基本设置
添加一个顶级broadcast 部分(与 bindings 相邻)。键是 WhatsApp 对等 ID:
- 群聊:群组 JID(例如
[email protected]) - 私聊:E.164 电话号码(例如
+15551234567)
处理策略
控制代理如何处理消息:并行(默认)
所有代理同时处理:顺序
代理按顺序处理(一个等待前一个完成):完整示例
工作原理
消息流
- 传入消息到达 WhatsApp 群组
- 广播检查:系统检查对等 ID 是否在
broadcast中 - 如果在广播列表中:
- 所有列出的代理处理消息
- 每个代理都有自己的会话键和隔离的上下文
- 代理并行(默认)或顺序处理
- 如果不在广播列表中:
- 应用正常路由(第一个匹配的绑定)
会话隔离
广播组中的每个代理完全独立维护:- 会话键(
agent:alfred:whatsapp:group:120363...vsagent:baerbel:whatsapp:group:120363...) - 对话历史(代理看不到其他代理的消息)
- 工作区(如果配置,则为独立沙箱)
- 工具访问(不同的允许/拒绝列表)
- 内存/上下文(独立的 IDENTITY.md、SOUL.md 等)
- 群组上下文缓冲区(用于上下文的最近群组消息)按对等共享,因此所有广播代理在触发时看到相同的上下文
- 不同的个性
- 不同的工具访问(例如,只读 vs 读写)
- 不同的模型(例如,opus vs sonnet)
- 安装不同的技能
示例:隔离会话
在群组[email protected] 中,代理为 ["alfred", "baerbel"]:
Alfred 的上下文:
最佳实践
1. 保持代理专注
为每个代理设计单一、明确的职责:❌ 坏: 一个通用的”dev-helper”代理
2. 使用描述性名称
明确每个代理的作用:3. 配置不同的工具访问
只给代理它们需要的工具:4. 监控性能
对于多个代理,请考虑:- 使用
"strategy": "parallel"(默认)以提高速度 - 将广播组限制为 5-10 个代理
- 对简单代理使用更快的模型
5. 优雅地处理失败
代理独立失败。一个代理的错误不会阻止其他代理:兼容性
提供程序
广播组目前支持:- ✅ WhatsApp(已实现)
- 🚧 Telegram(计划中)
- 🚧 Discord(计划中)
- 🚧 Slack(计划中)
路由
广播组与现有路由一起工作:GROUP_A: 只有 alfred 回复(正常路由)GROUP_B: agent1 和 agent2 回复(广播)
broadcast 优先于 bindings。
故障排除
代理不响应
检查:- 代理 ID 存在于
agents.list中 - 对等 ID 格式正确(例如,
[email protected]) - 代理不在拒绝列表中
只有一个代理响应
原因: 对等 ID 可能在bindings 中但不在 broadcast 中。
修复: 添加到广播配置或从绑定中删除。
性能问题
如果多个代理速度慢:- 减少每个组的代理数量
- 使用更轻的模型(sonnet 而不是 opus)
- 检查沙箱启动时间
示例
示例 1: 代码审查团队
回复:
- code-formatter:“修复了缩进并添加了类型提示”
- security-scanner:“⚠️ 第 12 行存在 SQL 注入漏洞”
- test-coverage:“覆盖率为 45%,缺少错误情况的测试”
- docs-checker:“函数
process_data缺少文档字符串”
示例 2: 多语言支持
API 参考
配置架构
字段
strategy(可选):如何处理代理"parallel"(默认):所有代理同时处理"sequential":代理按数组顺序处理
[peerId]: WhatsApp 群组 JID、E.164 号码或其他对等 ID- 值:应处理消息的代理 ID 数组
限制
- 最大代理数: 没有硬性限制,但 10+ 个代理可能会很慢
- 共享上下文: 代理看不到彼此的回复(按设计)
- 消息排序: 并行回复可能以任何顺序到达
- 速率限制: 所有代理都计入 WhatsApp 速率限制
未来增强
计划的功能:- 共享上下文模式(代理看到彼此的回复)
- 代理协调(代理可以相互发信号)
- 动态代理选择(根据消息内容选择代理)
- 代理优先级(某些代理在其他代理之前响应)