TinkerClaw WhatsApp 全能通道

要解决什么问题

很多 WhatsApp 自动化方案依赖 Docker（如 WAHA）、独立 CLI 或额外网关，部署和维护成本高，功能也往往只覆盖「发几条消息」。若你的 AI Agent 已经跑在 OpenClaw 上，更希望用 WhatsApp Web 协议 直接收发，并支持群组管理、投票、贴纸、语音、反应、编辑与撤回等完整交互，还需要在同一群聊里放多个 Agent 时避免「人人回复、费用爆炸」和回声循环，就需要一份与通道能力对齐的文档与约定。

技能如何工作

本技能描述 OpenClaw 原生 WhatsApp 通道（底层为 Baileys）可用的 22 种动作，不引入外部 Docker 服务或 CLI 包装器。前提：OpenClaw 已配置 WhatsApp 通道，并通过 openclaw whatsapp login 完成扫码绑定。

消息与互动

• 文本、媒体（JPG/PNG/GIF/MP4/PDF 等）、投票、贴纸（建议 WebP 512×512）、语音（建议 OGG/Opus）、GIF（需先转 MP4）
• 反应、回复/引用、编辑（仅自己的消息）、撤回

群组

• 创建、改名、图标、描述、增删成员、升降管理员、邀请链接的获取与撤销、Get Group Info 返回名称、描述、成员与管理员等

历史与联系人

• 全文检索；vCard / contactsArrayMessage 解析，联系人消息可带结构化号码便于按手机号搜索

JID：个人为 号码@s.whatsapp.net，群组为 id@g.us；to= 传手机号时 OpenClaw 会自动转换。

Protocol v2（多 Agent 群聊） 在 naive 全员回复之外提供：

• 路由：broadcast / addressed（@名字才回）/ round-robin
• 拥塞控制（Exponential Courtesy Protocol）：随 Agent 数量放大延迟、抖动、话多者加倍惩罚、碰撞则让路
• 会话生命周期：陈旧检测、附和循环检测、话题转向、目标跟踪与收尾协议
• 预算感知调度：Conservative / Moderate / Aggressive / Burn 等模式调节深度与 tangent 行为
• DM 侧扩展 triggerPrefix；1:1 可用 turn-end 标记（如 ⚡）表示一轮结束

可与 smart-model-router、agent-superpowers、subagent-overseer 等技能组合使用。

适用边界与注意点

• 反垃圾：避免群发、连发、向从未主动联系你的号码冷启动轰炸。
• 消息 ID：反应、编辑、撤回依赖消息 ID；入站事件与发送响应里会带上。
• 与其它技能对比：相对 wacli（Go CLI）、whatsapp-automation（Docker+WAHA），本路径强调原生集成与双向对话及完整群组能力；gif-whatsapp 仅侧重 GIF 发送。
• 多 Agent 讨论仍需合理配置路由与预算模式，否则仍可能浪费 token（Protocol v2 是缓解而非魔法）。