名称： wacli
描述： 通过 wacli CLI 向他人发送 WhatsApp 消息，或搜索/同步 WhatsApp 历史记录（不适用于普通用户聊天）。
主页： https://wacli.sh
元数据： {"clawdbot":{"emoji":"📱","requires":{"bins":["wacli"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/wacli","bins":["wacli"],"label":"通过 Homebrew 安装 wacli"},{"id":"go","kind":"go","module":"github.com/steipete/wacli/cmd/wacli@latest","bins":["wacli"],"label":"通过 Go 安装 wacli"}]}}

wacli

仅在用户明确要求你向 WhatsApp 上的其他人发送消息，或要求同步/搜索 WhatsApp 历史记录时，才使用 wacli。
请勿将 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 messages search "发票" --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 参数获取机器可读格式。
• 历史记录补全需要手机在线，结果为尽力而为。
• 常规用户聊天无需使用此 CLI 工具；它主要用于向他人发送消息。
• JID 格式：私聊为 <号码>@s.whatsapp.net；群聊为 <ID>@g.us（可通过 wacli chats list 查找）。