WhatsApp全能集成

技能简介

WhatsApp Ultimate 提供完整的 WhatsApp 集成能力，支持消息收发、多媒体处理、投票、贴纸、语音笔记、表情反应及全文历史搜索。基于原生 Baileys 库构建，无需 Docker 环境。

业务背景

企业可通过单一入口统一管理WhatsApp客户沟通，无需切换多个设备或账号。销售团队实时响应询盘，客服部门留存完整对话历史，管理层基于聊天数据洞察客户需求。原生架构部署简便，降低IT运维成本，同时保障商业对话的合规性与可追溯性。

落地案例：某跨境电商将WhatsApp接入订单系统后，客服人员直接在后台查看客户历史咨询记录，针对物流延误主动发起安抚消息并附赠优惠券链接。客户回复的语音消息自动转为文字存入工单，售后主管每周检索高频投诉关键词，识别出包装破损问题后协调仓库改进，客户满意度提升且重复咨询量减少。

能做什么

• 发送和接收文本、图片、视频、音频等多媒体消息
• 创建和管理投票、发送贴纸、处理语音笔记
• 语音内容自动转录为文字
• FTS5 全文检索历史消息记录
• 同步联系人信息，创建和管理群组
• 通过三规则安全网关控制自动回复范围

使用说明

安装指令：

clawhub install whatsapp-ultimate

可选补丁（安装后按需执行）：

该技能包含两个可选 bash 脚本，用于修补 OpenClaw 源文件：

1. scripts/apply-history-fix.sh — 修复自聊消息捕获功能
2. scripts/apply-model-prefix.sh — 添加模型标识前缀模板变量

两脚本均为幂等设计，重复执行安全；执行前请审阅脚本内容。可通过 git checkout 恢复原始文件。

基础调用示例：

whatsapp_history(action="search", query="meeting tomorrow")
whatsapp_history(action="search", chat="Oscar", limit=20)
whatsapp_history(action="stats")

输入与输出

见下方输入与输出表格。

风险提示

• 可选补丁会修改 OpenClaw 核心源文件，执行前务必人工审阅
• 管理员脚本 wa-fetch-contacts.ts 和 wa-create-group.ts 直接连接 WhatsApp，操作不可逆
• 需妥善保管 ~/.openclaw/credentials/whatsapp/ 目录下的凭证
• 启用 syncFullHistory: true 可能触发大量历史消息同步

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/globalcaos/whatsapp-ultimate/SKILL.md
来源类型：GitHub 仓库