name: wacli description: 通过 wacli CLI 向他人发送 WhatsApp 消息或搜索/同步 WhatsApp 历史记录(不用于普通用户聊天)。 homepage: https://wacli.sh metadata: { “openclaw”: { “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 用于普通用户聊天;OpenClaw 会自动路由 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获取机器可读的输出。 - 回填需要您的手机在线;结果是尽力而为的。
- WhatsApp CLI 不用于常规用户聊天;它用于向其他人发送消息。
- JID:直接聊天类似于
<number>@s.whatsapp.net;群组类似于<id>@g.us(使用wacli chats list查找)。