wacli 是一个面向 WhatsApp 的命令行工具（CLI），主要用于两类场景：一是代表用户向其他人发送 WhatsApp 消息，二是搜索或同步 WhatsApp 历史记录。它并不用于处理用户本人的日常聊天，因为 Clawdbot 会自动路由 WhatsApp 会话；如果用户正在 WhatsApp 上与助手对话，除非用户明确要求联系第三方，否则不应使用该工具。
用途与使用边界
wacli 仅在用户明确要求向他人发送 WhatsApp 消息，或要求同步/搜索 WhatsApp 历史时使用。不要将其用于普通用户聊天。
安全要求
使用发送功能时，需要明确的收件人和消息文本；发送前应确认收件人和消息内容；如果任何信息存在歧义，应先提出澄清问题。
认证与同步
可通过 wacli auth 进行 QR 登录并完成初始同步；使用 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，可通过 --store 覆盖。解析输出时可使用 --json 获得机器可读格式。JID 格式方面，直接聊天形如 <number>@s.whatsapp.net，群组形如 <id>@g.us，可用 wacli chats list 查找。WhatsApp CLI 不需要用于日常用户聊天，它用于向其他人发送消息。