SuperAPI AI 工具集

whatsapp-skill

办公与效率

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 WhatsApp Web 自动化发送和接收 WhatsApp 消息,适用于让 AI 助手代发消息、查看聊天记录、搜索消息或管理联系人。

主要能力:支持认证与状态查询、登出;向手机号或群组发送消息;列出最近聊天、读取指定聊天消息、搜索消息;列出联系人与群组;通过 --session 参数支持多账号。所有命令输出 JSON 便于解析。

使用方式:首次需安装依赖并认证。安装:cd ~/.claude/skills/whatsapp-skill && npm install。认证:node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js auth [--session NAME],终端显示二维码后用手机 WhatsApp 的“已关联的设备”扫码。发送:node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js send 14155551234 "Hello!" [--session NAME];发群组用 send-group GROUP_ID "..."。读取:chats、messages CHAT_ID、search "query"、contacts、groups,均可加 --limit N 和 --session。手机号须用国际格式,不含 + 和空格。聊天 ID 由 chats 命令返回,如 14155551234@c.us 或 120363123456789012@g.us。

限制与注意:发送任何消息前必须向用户展示收件人、完整消息文本和所用会话,并获明确确认后才能执行,绝不未经确认发送。每个 WhatsApp 账号同一时间只能关联一个会话;手机长时间断网可能导致断开;避免频繁发送以防封号。会话数据存于 ~/.claude/skills/whatsapp-skill/sessions/,含认证信息需妥善保管;登出会删除本地会话数据,但设备在 WhatsApp 中仍保持关联直到手动解除。需 Node.js 16+、npm 和 Chrome/Chromium。若二维码不显示,可运行 npx puppeteer browsers install chrome。