核心功能
whatsapp-ultimate 是 OpenClaw 平台的官方 WhatsApp 技能，提供原生级别的协议集成能力，覆盖消息收发、媒体处理、群组管理等22种核心操作。
核心用法
- 消息能力：文本、图片、视频、文档、语音消息（OGG/Opus）、轮询、贴纸（WebP）、GIF（MP4格式）
- 交互增强：消息回复/引用、表情反应（添加/移除）、消息编辑（仅限自己消息）、消息撤回
- 群组管理：创建/重命名/设置图标/描述、成员添加/移除/晋升/降级管理员、获取/撤销邀请链接、离开群组
- 历史检索：全文搜索、vCard联系人信息提取（含电话号码）
技术架构
采用直接协议集成：OpenClaw → WhatsApp Channel Plugin → Baileys (WhatsApp Web Protocol) → WhatsApp Servers，无需外部Docker容器或CLI工具，单节点部署。
显著优点
1. 完整性领先：对比 wacli（CLI）、whatsapp-automation（Docker）、gif-whatsapp 等方案，是唯一支持双向聊天、完整群组管理、消息编辑/撤回/反应等高级功能的原生集成
2. 零外部依赖：纯协议层实现，降低运维复杂度与安全攻击面
3. JID智能处理：自动转换电话号码与JID格式，支持LID/JID别名解析
4. 搜索增强：联系人消息存储电话号码至 text_content，支持按号码全文检索
潜在局限
- 格式约束严格：语音消息强制要求OGG/Opus，GIF需手动转为MP4，贴纸需WebP 512x512
- 反垃圾机制：WhatsApp主动限流，禁止批量发送、高频发送、向未互动联系人发消息
- 消息ID依赖：反应/编辑/撤回操作需预先获取messageId，无法对历史消息盲操作
- 生态绑定：仅限OpenClaw平台，无法独立部署
适合人群
- 需要自动化WhatsApp客服、通知、群运营的企业团队
- 追求低延迟、高可靠原生协议集成的开发者
- 需双向交互（接收+发送）而非单向推送的场景
常规风险
- 账号封禁：违反WhatsApp反垃圾政策可能导致商业账号限制
- 隐私合规：vCard提取涉及联系人电话号码，需符合GDPR/个人信息保护法规
- 协议变更：Baileys作为第三方库，WhatsApp协议更新可能导致功能中断
- 权限管理：群组管理功能（踢人、晋升）需谨慎配置，避免滥用导致群组混乱