WhatsApp命令行工具 wacli

wacli 是一款 WhatsApp 命令行工具,用于自动化消息发送、历史记录搜索与同步。它支持通过 CLI 向指定联系人发送文本或文件,搜索聊天记录,以及进行历史数据回填。适用于需要批量操作、数据备份或与第三方系统集成的场景。关键词:WhatsApp CLI,消息自动化,历史记录同步,命令行工具,数据备份。

DevOps 0 次安装 0 次浏览 更新于 2/24/2026

name: wacli description: 通过 wacli CLI 向他人发送 WhatsApp 消息或搜索/同步 WhatsApp 历史记录(不用于普通用户聊天)。 homepage: https://wacli.sh metadata: { “openclaw”: { “emoji”: “📱”, “requires”: { “bins”: [“wacli”] }, “install”: [ { “id”: “brew”, “kind”: “brew”, “formula”: “steipete/tap/wacli”, “bins”: [“wacli”], “label”: “安装 wacli (brew)”, }, { “id”: “go”, “kind”: “go”, “module”: “github.com/steipete/wacli/cmd/wacli@latest”, “bins”: [“wacli”], “label”: “安装 wacli (go)”, }, ], }, }

wacli

仅当用户明确要求您向他人发送 WhatsApp 消息或要求同步/搜索 WhatsApp 历史记录时,才使用 wacli。 请勿将 wacli 用于普通用户聊天;OpenClaw 会自动路由 WhatsApp 对话。 如果用户正在 WhatsApp 上与您聊天,除非他们要求您联系第三方,否则不应使用此工具。

安全注意事项

  • 需要明确的收件人 + 消息文本。
  • 发送前确认收件人 + 消息。
  • 如有任何模糊之处,请提出澄清问题。

认证与同步

  • wacli auth(二维码登录 + 初始同步)
  • wacli sync --follow(持续同步)
  • wacli doctor

查找聊天与消息

  • wacli chats list --limit 20 --query "姓名或号码"
  • wacli messages search "查询内容" --limit 20 --chat <jid>
  • wacli messages search "发票" --after 2025-01-01 --before 2025-12-31

历史记录回填

  • wacli history backfill --chat <jid> --requests 2 --count 50

发送消息

  • 文本: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(可使用 --store 覆盖)。
  • 解析时使用 --json 获取机器可读的输出。
  • 回填需要您的手机在线;结果是尽力而为的。
  • WhatsApp CLI 不用于常规用户聊天;它用于向其他人发送消息。
  • JID:直接聊天类似于 <number>@s.whatsapp.net;群组类似于 <id>@g.us(使用 wacli chats list 查找)。