核心用法
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 服务条款，避免账号封禁。
数据泄露风险：本地数据库未加密，设备入侵可导致消息历史泄露。