WhatsApp消息工具

技能简介

wacli 是一个命令行工具，用于向他人发送 WhatsApp 消息或搜索/同步 WhatsApp 历史记录。该工具通过 QR 码登录实现身份验证，支持文本、文件发送到个人或群组，并提供聊天记录的查询与历史回填功能。

能做什么

• 向指定手机号或群组发送文本消息
• 发送带说明的文件附件
• 搜索特定关键词的历史消息
• 同步并持续跟踪聊天更新
• 批量回填历史聊天记录
• 列出聊天列表并筛选联系人

使用说明

安装方式（二选一）：

# Homebrew 安装
brew install steipete/tap/wacli

# Go 安装
go install github.com/steipete/wacli/cmd/wacli@latest

首次使用步骤：

1. 执行 wacli auth 完成 QR 码扫码登录与初始同步
2. 运行 wacli doctor 检查环境状态
3. 可选执行 wacli sync --follow 开启持续同步模式

常用操作示例：

• 查找聊天：wacli chats list --limit 20 --query "姓名或号码"
• 搜索消息：wacli messages search "发票" --after 2025-01-01
• 发送文本：wacli send text --to "+14155551212" --message "下午3点方便吗？"
• 发送文件：wacli send file --to "+14155551212" --file /path/议程.pdf --caption "会议议程"
• 历史回填：wacli history backfill --chat <jid> --requests 2 --count 50

数据默认存储于 ~/.wacli 目录，可通过 --store 参数修改；添加 --json 可获取机器可读输出。

输入与输出

见下方输入与输出表格。

风险提示

• 仅限用户明确要求联系第三方或查询历史时使用，不可用于常规对话场景
• 发送前必须明确确认收件人与消息内容，模糊情况需询问澄清
• 历史回填需要手机保持在线，结果取决于网络与服务器状态
• 群组 ID 格式为 <id>@g.us，个人聊天为 <号码>@s.whatsapp.net
• 频繁操作可能触发 WhatsApp 服务限制

来源信息

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