核心用法
whatsapp-ultimate 是 OpenClaw 生态中针对 WhatsApp 的深度原生集成方案，基于 Baileys WhatsApp Web 协议实现，无需 Docker、CLI 工具或外部服务。该技能提供 22 种独立操作能力，覆盖完整的消息生命周期与群组管理场景。
消息能力包括：文本、图片/视频/文档等多媒体、投票、WebP 格式贴纸、OGG/Opus 语音消息、GIF（需 MP4 格式转换）。交互增强涵盖：表情回应、引用回复、消息编辑、撤回（unsend）。群组管理提供：创建、重命名、图标/描述设置、成员增删、管理员升降级、进退群、邀请链接生成与吊销、群组信息获取。
关键配置通过 message 工具调用，支持自动 JID 格式转换（+34612345678 → 34612345678@s.whatsapp.net）。高级特性如 ackMessage 可在网关心实现即时送达回执（如发送"⚡"），早于模型推理阶段，用于视觉区分人工与 bot 消息。
显著优点
1. 原生集成深度：直接嵌入 OpenClaw 架构，对比 wacli（CLI 依赖）、whatsapp-automation（Docker 依赖）等方案，消除外部故障点，部署复杂度最低。
2. 功能完整性：独家覆盖投票、贴纸、语音消息、消息编辑/撤回、完整群组管理等竞品缺失的能力，是唯一支持双向对话的原生方案。
3. 协议级优化：基于 Baileys 实现消息 ID 追踪、媒体下载（从历史记录解密 WhatsApp CDN 内容）、JID/LID 别名解析，技术实现严谨。
4. 安全设计："3-rule security gate"原则——仅在正确聊天中、由正确的人、在被呼叫时响应，降低误触风险。
潜在局限
- 格式刚性：语音消息强制要求 OGG/Opus，GIF 需先转 MP4，贴纸需 WebP 512×512，需 ffmpeg 预处理。
- 反垃圾策略：WhatsApp 主动限流，禁止批量发送、高频消息、冷启动群发，存在账号封禁风险。
- 媒体过期：历史消息媒体 URL 约 2 周后失效，需及时下载。
- 生态锁定：深度绑定 OpenClaw 架构，无法独立运行。
适合人群
- 需将 AI Agent 深度嵌入 WhatsApp 工作流的团队（客服、社群运营、内部协作）
- 追求部署简洁性、反感 Docker/CLI 复杂链路的开发者
- 需要消息编辑/撤回/投票等高级交互的产品场景
常规风险
账号安全：违反 WhatsApp 商业政策可能导致号码封禁。隐私合规：群组管理涉及成员数据操作，需 GDPR/数据法合规审查。依赖风险：Baileys 为 unofficial 协议实现，WhatsApp 官方可能变更协议导致中断。建议生产环境配置备用通道。