wacli 是一个面向 WhatsApp 的命令行工具（CLI），主要用于两类任务：一是代替用户向其他人发送 WhatsApp 消息；二是搜索或同步 WhatsApp 历史记录。它不用于普通用户日常聊天场景——当用户直接在 WhatsApp 中对话时，会话由 Clawdbot 自动路由，不应调用此工具；只有在用户明确要求联系第三方或检索历史时才使用。
主要能力：
- 认证与同步：wacli auth 执行二维码登录并完成初始同步；wacli sync --follow 持续同步；wacli doctor 用于诊断。
- 查找聊天与消息：wacli chats list --limit 20 --query "name or number" 列出聊天；wacli messages search "query" --limit 20 --chat <jid> 在指定聊天中搜索；也支持用 --after 和 --before 限定日期范围搜索。
- 历史回填：wacli history backfill --chat <jid> --requests 2 --count 50，需要手机在线，结果尽力而为。
- 发送消息：发送文本使用 wacli send text --to "+14155551212" --message "..."；群组消息的接收方使用形如 1234567890-123456789@g.us 的 JID；发送文件使用 wacli send file --to ... --file /path/agenda.pdf --caption "Agenda"。
使用方式与注意点：数据默认存储在 ~/.wacli，可用 --store 覆盖；解析输出时使用 --json 获取机器可读结果。JID 格式方面，单聊形如 <number>@s.whatsapp.net，群组形如 <id>@g.us，可用 chats list 查找。安全要求：必须取得明确的收件人和消息文本；发送前确认收件人与内容；存在任何歧义时先提出澄清问题。
适用场景：代替用户向第三方发送文本、群组消息或文件；按关键词与时间范围检索历史消息；对指定聊天回填历史记录。限制：不适合普通用户聊天；历史回填依赖手机在线且结果不保证完整。