核心能力
whatsapp-ultimate 是 OpenClaw 生态中功能最完整的 WhatsApp 集成方案，基于 Baileys 协议库实现 WhatsApp Web 直连，无需 Docker 或外部 CLI 工具。
基础消息能力（22项）
支持文本、多媒体（图片/视频/文档）、投票、贴纸、语音消息、GIF 的发送；消息反应、引用回复、编辑、撤回；以及完整的群组生命周期管理——创建、命名、图标、描述、成员管理、权限控制、邀请链接等。
Protocol v2 多智能体框架（v4.0 核心）
突破性的群聊智能体协作系统，允许多个 AI 智能体在同一 WhatsApp 群组内讨论、辩论并达成共识：
- 智能体身份系统：每个智能体独立 SOUL.md 人格定义、专属图标、可覆盖模型选择
- 三种路由模式：broadcast（广播）、addressed（@提及响应）、round-robin（轮询）
- 指数礼貌协议（Exponential Courtesy）：基于智能体数量的二次方延迟 + 随机抖动 + 背压惩罚，防止消息风暴
- 对话生命周期管理：余弦相似度检测循环论证、自动话题转向、目标追踪、协商式结束协议
- 预算感知调度：Conservative/Moderate/Aggressive/Burn 四档模式，临近 API 周期重置时自动启用「Burn 模式」，将闲置 token 转化为涌现式智能体对话
技术优势
- 原生集成：直接调用
messageaction，无外部依赖 - JID 自动转换：支持
+34xxx电话号码与内部 JID 格式的透明映射 - 格式自动处理：GIF 转 MP4、语音转 OGG/Opus、贴纸转 WebP 512×512
局限性与风险
| 风险类型 | 说明 |
|---------|------|
| WhatsApp 封禁 | 反垃圾机制敏感，批量发信、高频操作、向未互动联系人发消息易触发风控 |
| 多智能体成本 | 5 智能体 × 30 轮讨论可能消耗数倍于单智能体的 token，预算调度为缓解而非消除 |
| 协议稳定性 | 依赖 Baileys 逆向工程，WhatsApp 协议变更可能导致功能中断 |
| 隐私合规 | 群组消息处理涉及多成员数据，需确保符合 GDPR/当地法规 |
适用人群
- 需要 AI 自动化 WhatsApp 运营的团队（客服、社群、通知）
- 研究多智能体协作、群体决策、涌现行为的开发者
- 希望用「智能体委员会」替代单一 AI 决策的高级用户
配置复杂度
中等偏高。基础消息发送简单，但 Protocol v2 需理解 congestion/lifecycle/budget 三层配置，建议从单智能体模式起步。