用途:wacli 用于通过命令行操作 WhatsApp,仅在用户明确要求给其他人发消息,或要求同步、搜索 WhatsApp 历史时使用。普通用户聊天由 Clawdbot 自动路由,不应调用此工具;若用户本身在 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 history backfill --chat <jid> --requests 2 --count 50),以及发送文本、群组消息和文件(wacli send text / wacli send file)。
使用方式:需要先认证,可运行 wacli auth 完成扫码登录和初始同步,再用 wacli sync --follow 持续同步。发送时需明确收件人和消息内容,例如 wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"。JID 格式:单聊形如 <number>@s.whatsapp.net,群组形如 <id>@g.us,可用 wacli chats list 查找。
安全与限制:必须要求明确的收件人和消息文本;发送前确认收件人和消息;若有歧义应先提出澄清问题。数据默认存于 ~/.wacli,可用 --store 覆盖;用 --json 获取机器可读输出。历史回填需要手机在线,结果尽力而为。普通用户聊天无需此工具。