介绍
# wacli
仅在用户明确要求您通过 WhatsApp 向其他人发送消息，或要求同步/搜索 WhatsApp 历史记录时使用 `wacli`。 对于正常的用户聊天，请勿使用 `wacli`；Clawdbot 会自动路由 WhatsApp 对话。 如果用户是在 WhatsApp 上与您聊天，除非他们要求您联系第三方，否则您不应使用此工具。
Safety（安全） - 要求明确提供接收者 + 消息文本。 - 发送前确认接收者 + 消息内容。 - 如果有任何歧义，请提出澄清问题。
Auth + sync（认证与同步） - `wacli auth` (QR 登录 + 初始同步) - `wacli sync --follow` (持续同步) - `wacli doctor`
Find chats + messages（查找聊天与消息） - `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`
History backfill（历史记录回填） - `wacli history backfill --chat <jid> --requests 2 --count 50`
Send（发送） - 文本：`wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"` - 群组：`wacli send text --to "[email protected]" --message "Running 5 min late."` - 文件：`wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"`
Notes（备注） - 存储目录：`~/.wacli` (可通过 `--store` 覆盖)。 - 解析时请使用 `--json` 获取机器可读的输出。 - 回填需要您的手机在线；结果仅做最大努力。 - 日常用户聊天不需要使用 WhatsApp CLI；它用于给其他人发送消息。 - JID：直接聊天看起来像 `<number>@s.whatsapp.net`；群组看起来像 `<id>@g.us` (使用 `wacli chats list` 查找)。