wacli

仅当用户明确要求你通过WhatsApp向他人发送消息，或要求同步/搜索WhatsApp历史记录时使用。wacli对于正常的用户聊天，请勿使用此工具；Clawdbot会自动路由WhatsApp对话。 如果用户正在WhatsApp上与你聊天，除非他们要求你联系第三方，否则不应使用此工具。安全需要明确的收件人和消息内容。

发送前确认收件人和消息。

• 如有任何不明确之处，请提出澄清性问题。
• 认证与同步
• wacli auth

（二维码登录 + 初始同步）

• wacli sync --follow（持续同步）
• wacli doctor查找聊天与消息
• wacli chats list --limit 20 --query "姓名或号码"

wacli messages search "查询内容" --limit 20 --chat <jid>

• 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 "你好！你下午3点有空吗？"
• 群组：wacli send text --to "1234567890-123456789@g.us" --message "会晚到5分钟。"
• 文件：wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "议程"

注意事项

• 存储目录：~/.wacli（可通过--store参数覆盖）。
• 解析时使用--json参数可获得机器可读的输出。
• 回填操作需要您的手机在线；结果仅为尽力而为。
• WhatsApp CLI 并非日常用户聊天所需；它是用于向其他人发送消息的。
• JID：直接聊天（私聊）的格式如下<号码>@s.whatsapp.net；群组的格式如下<ID>@g.us（可通过wacli chats list命令查找）。