用途:wacli 仅在用户明确要求向其他人在 WhatsApp 上发消息,或要求同步/搜索 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 history backfill --chat <jid> --requests 2 --count 50。 发送:文本 wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?";群组 wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late.";文件 wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"。
安全与限制:必须提供明确收件人和消息文本;发送前确认收件人与消息;如有歧义需先询问澄清。存储目录为 ~/.wacli(可用 --store 覆盖)。解析时用 --json 获得机器可读输出。回填需手机在线,结果尽力而为。常规用户聊天无需该 CLI。JID 格式:直聊如 <number>@s.whatsapp.net,群组如 <id>@g.us(用 wacli chats list 查找)。