核心用法
whatsapp-ultimate 是 OpenClaw 的原生 WhatsApp 频道技能，通过 Baileys 库直接连接 WhatsApp Web 协议，无需外部 Docker 服务或 CLI 包装器。用户通过简单的 message 工具调用即可执行 22 种操作，涵盖个人消息（文本、媒体、投票、贴纸、语音、GIF）、消息交互（反应、引用回复、编辑、撤回）及完整群组管理（创建、成员管理、权限设置、邀请链接）。
Protocol v2 是该技能的重大升级，引入了多智能体群组讨论框架。多个 AI 代理可在指定 WhatsApp 群组中进行结构化对话，支持三种路由模式：broadcast（全员响应）、addressed（点名响应）、round-robin（轮询）。配合指数级礼貌协议（Exponential Courtesy Protocol）的拥塞控制，防止消息爆炸；通过余弦相似度检测讨论停滞，实现话题引导和自动收尾。
预算感知调度 是另一亮点，根据 API 使用量和重置时间动态调整对话深度，包括保守、适度、激进和"燃尽模式"（Burn Mode）——在额度即将重置前鼓励自由探索，避免浪费。
显著优点
- 原生集成：直接协议层对接，零外部依赖，部署极简
- 功能完备：覆盖 WhatsApp 绝大多数原生功能，包括投票、贴纸、语音等高级特性
- 多智能体协作：业界罕见的生产级多 AI 群组讨论方案，支持个性配置、动态路由、智能节流
- 成本优化：预算感知调度让 API 额度使用更高效
- 双向通信：真正的收发一体，支持基于触发前缀的访问控制
潜在局限
- WhatsApp 封号风险：使用非官方协议存在被检测可能，需遵守速率限制，避免批量消息
- 格式要求严格：语音须 OGG/Opus，贴纸须 WebP，GIF 需转 MP4，需要 ffmpeg 预处理
- 多智能体配置复杂：SOUL.md 人格文件、路由模式、生命周期参数需要细致调优
- 依赖 OpenClaw 生态：无法独立运行，需完整 OpenClaw 环境
适合人群
- 需要自动化 WhatsApp 通信的个人开发者或小型团队
- 探索多智能体协作、AI 角色扮演实验的研究者
- 希望在 WhatsApp 群组中部署 AI 助理的企业客服场景
- 对 API 成本敏感、需要精细化预算管理的用户
常规风险
- 账号安全：违反 WhatsApp 服务条款可能导致临时或永久封号
- 隐私合规：处理联系人信息、vCard 数据需符合 GDPR 等法规
- 消息失控：多智能体模式下配置不当可能导致 spam 或讨论发散
- 技术债务：依赖 Baileys 库，若 WhatsApp 协议变更需等待上游更新