核心用法
whatsapp-ultimate 是 OpenClaw 平台的原生 WhatsApp 通道技能，通过 Baileys 库直接对接 WhatsApp Web 协议，无需 Docker 容器或 CLI 外部工具。用户仅需执行 openclaw whatsapp login 完成 QR 码扫码即可激活。
完整能力矩阵（22 项）：
| 类别 | 功能 |
|------|------|
| 消息发送 | 文本、图片、视频、文档、语音（OGG/Opus）、GIF（MP4 封装）、贴纸（WebP）、投票 |
| 消息交互 | 表情回应、引用回复、编辑、撤回 |
| 群组管理 | 创建、重命名、图标、描述、成员增删、升降管理员、邀请链接、退群、信息查询 |
典型调用示例：
# 发送语音消息 message action=send channel=whatsapp to="+34612345678" filePath=/path/audio.ogg asVoice=true # 创建投票 message action=poll channel=whatsapp to="+34612345678" pollQuestion="What time?" pollOption=["3pm", "4pm"] # 群组管理 message action=promoteParticipant channel=whatsapp groupJid="123@g.us" participants=["+34612345678"]
显著优点
- 零外部依赖：纯 TypeScript 实现，对比 wacli（需 Go 二进制）、whatsapp-automation（需 Docker+WAHA）部署极简
- 双向实时通信：支持接收消息与主动发送，实现真正对话式 Agent，竞品多为单向推送
- 协议级完整功能：覆盖 WhatsApp 官方客户端 90% 以上交互场景，包括投票、贴纸、语音等高级特性
- 安全沙箱设计：3.5.0 版本引入
ackMessage网关级确认机制，可在模型推理前发送即时状态提示
潜在缺点与局限性
- 格式严格性：语音须 OGG/Opus、贴纸须 WebP 512×512、GIF 须转码为 MP4，需配合 ffmpeg 预处理
- 反垃圾机制：WhatsApp 对批量群发、高频消息、陌生联系人首条消息有严格风控，存在封号风险
- 协议敏感性：依赖非官方 Baileys 库，WhatsApp 协议变更可能导致功能中断
- 号码隐私：需绑定真实 WhatsApp 账号，企业场景需考虑号码资产隔离
适合人群
- 需构建 WhatsApp 客服 Bot 的中小企业
- 希望避免 Docker/CLI 复杂运维的个人开发者
- 需要群组自动化管理（通知、投票、成员权限）的社区运营者
- 追求低延迟双向对话的 AI Agent 构建者
常规风险
| 风险类型 | 说明 | 缓解建议 |
|----------|------|----------|
| 账号封禁 | 触发 WhatsApp 反垃圾策略 | 控制消息频率，优先回复已联系用户，避免冷启动群发 |
| 协议失效 | Meta 更新 Web 协议 | 关注 Baileys 社区更新，保持 skill 版本同步 |
| 数据隐私 | 消息内容流经 OpenClaw 实例 | 部署私有化实例，启用端到端加密备份 |
| JID 混淆 | 个人/群组 ID 格式错误导致投递失败 | 使用 `to=` 参数让系统自动转换，手动校验 `@s.whatsapp.net` 与 `@g.us` 后缀 |