wacli 是一个 WhatsApp 命令行工具（CLI），主要用于两类场景：一是用户明确要求你通过 WhatsApp 联系其他人，二是用户要求同步或搜索 WhatsApp 历史记录。它不适用于普通用户聊天；OpenClaw 会自动路由 WhatsApp 会话。如果用户正在 WhatsApp 上与你聊天，除非他们要求你联系第三方，否则不应使用此工具。
用途
wacli 面向的是“代用户向他人发送 WhatsApp 消息”以及“同步/搜索 WhatsApp 历史”这两类明确需求。普通用户聊天不需要也不应使用该工具。
主要能力
- 认证与同步：wacli auth 用于二维码登录和初始同步；wacli sync --follow 用于持续同步；wacli doctor 用于检查状态。
- 查找聊天与消息：wacli chats list --limit 20 --query "name or number" 可列出聊天；wacli messages search "query" --limit 20 --chat <jid> 可按聊天搜索消息；wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31 可按时间范围搜索。
- 历史回填：wacli history backfill --chat <jid> --requests 2 --count 50。
- 发送消息：文本发送 wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"；群组发送 wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."；文件发送 wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"。
使用方式与安全要求
使用 wacli 发送消息时，需要明确的收件人和消息文本；发送前应确认收件人和消息内容；如果任何信息不明确，应先提出澄清问题。
注意事项
- 存储目录为 ~/.wacli，可用 --store 覆盖。
- 解析输出时可使用 --json 获得机器可读的结果。
- 历史回填需要手机在线，结果尽力而为。
- WhatsApp CLI 不用于日常用户聊天，而是用于联系其他人。
- JID 格式：直接聊天形如 <number>@s.whatsapp.net；群组形如 <id>@g.us（可用 wacli chats list 查找）。
适用场景
当用户明确要求向他人发送 WhatsApp 消息，或要求同步/搜索 WhatsApp 历史记录时适用。
限制
不用于普通用户聊天；发送需要明确收件人与消息并确认；历史回填依赖手机在线且结果尽力而为。关于收费、价格、平台支持范围等更多信息，资料中暂未提供。