TinkerClaw WhatsApp

📱 原生 WhatsApp 智能体群控中枢

WhatsApp原生协议级AI代理集成,支持多智能体群聊协作与成本可控的并发对话调度,22种消息与群组管理功能。

收藏
14.8k
安装
3.2k
版本
4.0.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

WhatsApp Ultimate 综合评估

核心用法

本技能是 OpenClaw/TinkerClaw 生态的 WhatsApp 原生通道插件,基于 Baileys 库实现 WhatsApp Web 协议直连,无需 Docker 或外部 CLI 工具。覆盖四大功能域:

| 域 | 关键能力 |
|--|--|
| **消息** | 文本、媒体(图/视频/文档)、投票、贴纸、语音消息、GIF |
| **交互** | 表情回应、引用回复、消息编辑、撤回 |
| **群组** | 创建、重命名、图标/描述设置、成员管理、邀请链接、权限控制 |
| **历史** | 全文搜索、vCard 联系人提取 |

协议 v2 核心创新 在于解决"多代理同群聊天"的成本灾难:通过指数礼貌协议(Exponential Courtesy Protocol)实现拥塞控制,对话生命周期管理检测循环讨论,预算感知调度在 API 重置前主动消耗剩余额度(Burn Mode)。

配置示例要点

  • 多代理身份:每个代理独立 SOUL.md 人格文件、图标、可选模型覆盖
  • 三种路由模式:broadcast(全响应)、addressed(点名响应)、round-robin(轮流)
  • 四档预算模式:Conservative → Moderate → Aggressive → Burn,自动调节响应频率与话题深度

显著优点

1. 原生集成深度:直接调用 OpenClaw message 工具,无外部依赖链条,延迟与故障点最小化
2. 成本可控的多智能体协作:业界罕见的"API 账单感知"设计,通过延迟抖动、staleness 检测、burn mode 三重机制,将多代理群聊从"成本黑洞"转为"预算优化实验"

3. 功能完整度领先:对比表格显示,在 14 项功能中本技能 100% 覆盖,竞品 CLI/Docker 方案普遍缺失媒体、投票、贴纸、反应、编辑等现代 WhatsApp 特性

4. 生产级细节:JID 格式自动转换、OGG/Opus 语音格式指引、WebP 贴纸转换命令、GIF→MP4 预处理脚本,降低开发者踩坑成本

5. 开放生态定位:明确归属 TinkerClaw 分叉,鼓励 fork/mod,MIT 协议

潜在缺点与局限性

| 局限 | 说明 |
|--|--|
| **平台锁定** | 深度绑定 OpenClaw/TinkerClaw 架构,无法独立运行于其他框架 |
| **协议风险** | 依赖 Baileys(非官方 WhatsApp Web 逆向工程),Meta 可能随时调整协议导致功能中断 |
| **反垃圾机制** | 明确警告:批量消息、快速连发、向未互发消息的用户发送内容会触发封号 |
| **Burn Mode 伦理模糊** | "为了不浪费 token 而鼓励发散讨论"的设计,可能产生低价值输出,实际 ROI 待验证 |
| **复杂度门槛** | YAML 配置层级较深(congestion → lifecycle → budget → multiAgent),新手调试成本高 |
| **无消息接收示例** | 全文侧重发送能力,接收/事件处理逻辑仅一笔带过 |

适合人群

  • 多智能体研究者:需要观察 3-5 个 LLM 角色在真实群聊中的 emergent behavior
  • 成本敏感的生产部署:API 预算有硬性天花板,需自动节流机制
  • OpenClaw/TinkerClaw 用户:已在该生态内,追求功能最全的 WhatsApp 通道
  • 自动化运维场景:需通过 WhatsApp 发送监控告警、接收 on-call 确认、管理值班群组

常规风险

  • 账号安全:WhatsApp 商业账号与个人账号均可能因"非人类行为模式"被限制,建议专用号码
  • API 供应商锁定:Burn mode 等预算功能深度绑定 Anthropic 的 usage API,迁移需重构
  • 配置漂移风险:多层级 YAML 的数值参数(如 stalenessThreshold: 0.85)缺乏运行时验证,误配易导致群聊"死锁"或"话痨"
  • 隐私合规:vCard 提取功能自动解析联系人手机号,在 GDPR 等法域需明确用户授权

总体评价

技术实现扎实、功能覆盖全面、成本控制理念前瞻,是 OpenClaw 生态中 WhatsApp 通道的事实标准。但配置复杂度和平台绑定性意味着:适合已有 TinkerClaw 基础架构的进阶用户,而非即插即用的轻量需求。

TinkerClaw WhatsApp 内容

scripts文件夹
手动下载zip · 15.1 kB
apply-history-fix.shtext/x-shellscript
请选择文件