wacli

wacli

仅当用户明确要求你通过 WhatsApp 给其他人发消息，或要求你同步或搜索 WhatsApp 历史记录时，才使用 wacli。 常规用户聊天不要使用 wacli；OpenClaw 会自动路由 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 messages show --chat <jid> --id <message_id> --json --full
• messages show 同时要求提供 --chat 和 --id；不要将消息 ID 作为位置参数传入。
• 发送后，如果格式必须完全一致，请验证已存储的消息，尤其是多行文本。

历史记录回填

• 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 "[email protected]" --message "Running 5 min late."
• 文件：wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"
• 多行：--message 默认按字面值处理；传入 --message-escapes 以解析 \n、\r、\t。

注意

• 存储目录：~/.wacli（使用 --store 覆盖）。
• 解析输出时，使用 --json 获取机器可读的输出。
• 回填要求手机在线；结果仅为尽力提供。
• 日常用户聊天不需要 WhatsApp 命令行；它用于给其他人发送消息。
• JID：单聊类似于 <number>@s.whatsapp.net；群聊类似于 <id>@g.us（使用 wacli chats list 查找）。