name: wacli
description: 通过 wacli CLI 向他人发送 WhatsApp 消息或搜索/同步 WhatsApp 历史记录（不适用于普通用户聊天）。
homepage: https://wacli.sh
metadata: {"clawdbot":{"emoji":"📱","requires":{"bins":["wacli"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/wacli","bins":["wacli"],"label":"安装 wacli (brew)"},{"id":"go","kind":"go","module":"github.com/steipete/wacli/cmd/wacli@latest","bins":["wacli"],"label":"安装 wacli (go)"}]}}

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 "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 查找）。