核心用法
whatsapp-ultimate 是 OpenClaw 平台最完整的 WhatsApp 集成技能,基于 Baileys 原生协议实现,无需 Docker 或外部 CLI 工具。该技能提供 22 种独立操作,覆盖消息发送(文本、媒体、投票、贴纸、语音、GIF)、消息交互(反应、回复、编辑、撤回)、群组全生命周期管理(创建、重命名、成员管理、权限控制)以及历史消息管理四大核心场景。
用户通过 message 工具调用各类操作,配合 whatsapp_history 工具实现基于 SQLite + FTS5 的全文搜索。历史同步功能支持通过重新链接设备拉取数年消息记录,语音消息可下载解密后转录为文本。
显著优点
功能完整性:对比 wacli 和 whatsapp-business,该技能是唯一支持投票、贴纸、语音消息、GIF、消息反应、编辑/撤回、完整群组管理等高级功能的方案。
原生集成:零外部依赖,直接通过 Baileys 与 WhatsApp 服务器通信,避免第三方 API 限制和商业账户要求。
数据主权:所有消息本地存储于 SQLite,支持全文搜索和历史导入导出,用户完全掌控数据。
灵活访问控制:提供 open/allowlist/pairing/disabled 四级策略,支持触发前缀和自聊模式,满足个人到企业的不同安全需求。
潜在缺点与局限性
格式兼容性:语音消息强制要求 OGG/Opus 格式,GIF 需转换为 MP4,贴纸需 WebP 格式,需要 ffmpeg 预处理。
反垃圾机制:WhatsApp 对批量消息和陌生联系人发送有限制,不适合大规模营销场景。
历史同步依赖:完整历史同步需重新链接设备,过程需要用户手动扫码,无法后台静默完成。
媒体时效性:下载的媒体 URL 会过期,需及时获取或保持活跃连接。
适合的目标群体
- 需要自动化 WhatsApp 客服或通知的中小企业
- 研究团队和社区管理员,需要归档和搜索群聊历史
- 个人用户构建 AI 助手管理社交沟通
- 开发者集成 WhatsApp 到现有工作流,替代官方商业 API
使用风险
性能风险:大型群组历史同步可能耗时数分钟,SQLite 在极端数据量下需优化索引。
依赖风险:Baileys 库更新可能影响协议兼容性,需关注上游安全补丁。
合规风险:自动化消息发送需遵守 WhatsApp 服务条款,避免账号封禁。
数据泄露风险:本地数据库未加密,设备入侵可导致消息历史泄露。