WhatsApp消息发送

技能简介

wacli 是一个命令行工具，用于向他人发送 WhatsApp 消息或搜索/同步 WhatsApp 历史记录。该工具适用于需要代发消息给第三方或批量处理聊天记录的场景，不用于日常用户对话。

业务背景

适用于企业代发通知、批量处理客服记录或归档历史消息的场景。通过命令行工具实现WhatsApp消息的自动化发送与聊天记录管理，减少人工操作成本，确保信息触达的准确性与可追溯性。

落地案例：某电商运营团队需在促销期间向VIP客户群发活动通知。运营人员使用wacli配置目标群组JID，编写标准化文案后批量发送；同时执行sync –follow持续同步客户回复，后续通过搜索关键词快速定位咨询记录，完成售后跟进与数据归档。

能做什么

• 向指定手机号或群组发送文本消息
• 发送带说明的文件（PDF、图片等）
• 搜索特定关键词的聊天记录
• 同步并持续跟踪消息历史
• 批量回填指定聊天的历史消息

使用说明

安装 wacli：

# 方式一：Homebrew
brew install steipete/tap/wacli

# 方式二：Go 安装
go install github.com/steipete/wacli/cmd/wacli@latest

首次使用流程：

1. 执行 wacli auth，扫描二维码完成登录与初始同步
2. 运行 wacli doctor 检查环境状态
3. 如需持续同步，执行 wacli sync --follow

查找聊天对象：

wacli chats list --limit 20 --query "姓名或号码"

发送消息示例：

# 发送文本给个人
wacli send text --to "+14155551212" --message "下午3点方便吗？"

# 发送文本给群组
wacli send text --to "1234567890-123456789@g.us" --message "迟到5分钟"

# 发送文件
wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "会议议程"

搜索历史记录：

wacli messages search "发票" --after 2025-01-01 --before 2025-12-31 --limit 20

其他常用命令：

# 回填历史消息
wacli history backfill --chat <jid> --requests 2 --count 50

# JSON 格式输出（便于解析）
wacli chats list --json

存储与配置：数据默认存放于 ~/.wacli，可通过 --store 指定其他路径。

输入与输出

见下方输入与输出表格。

风险提示

• 必须明确指定收件人和消息内容，禁止模糊操作
• 发送前需二次确认收件人身份与消息文本
• 回填历史需要手机保持在线，结果可能不完整
• 群聊 ID 格式为 <id>@g.us，个人为 <number>@s.whatsapp.net
• 该工具不用于常规用户对话，仅用于联系第三方

来源信息

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