wacli

• 您希望您的智能体代表您向特定联系人或群组发送 WhatsApp 消息（例如，通知客户、提醒团队群组）。
• 您需要以编程方式搜索过去的 WhatsApp 对话，查找特定关键词、日期或联系人。
• 您希望将 WhatsApp 历史记录同步并回填到本地存储中，以便进行下游处理或查询。
• 您需要向 WhatsApp 收件人发送文件或文档（PDF、图片等），并可附带可选说明文字。

• 您正在通过 WhatsApp 亲自与该代理聊天 —— OpenClaw 会自动处理这些对话；请勿为您自己的聊天会话调用 wacli。
• 您需要实时接收或回复传入的 WhatsApp 消息；wacli 是一个外发/查询工具，而非收件箱监听器。
• 收件人或消息内容不明确 —— 发送前请务必确认相关详情。

使用 wacli send text 向任意电话号码或 WhatsApp 群组 JID 发送消息。支持私聊（<number>@s.whatsapp.net）和群聊（<id>@g.us）两种方式。

使用 wacli send file 向任意 WhatsApp 联系人或群组发送文件（PDF、图片等），并可附带可选的说明文字。

使用 wacli messages search 按关键词、日期范围和聊天记录查询已同步的 WhatsApp 历史记录。在采取行动之前，可用于检索过去的对话内容。

wacli chats list 允许你按姓名或号码搜索联系人或群组，并返回其 JID，以便在特定聊天中发送消息或进行搜索。

使用 wacli history backfill 从 WhatsApp 服务器中检索较旧的消息并存入本地存储。需要您的手机保持在线；结果为尽力而为。

wacli auth 负责处理基于二维码的登录与初始同步。wacli sync --follow 持续更新您的本地存储。wacli doctor 帮助诊断连接问题。

当代理检测到会议延误或状态变更时，无需任何手动操作，即可使用 wacli send text 向相关联系人或 WhatsApp 群组聊天发送通知。

代理生成 PDF 报告或议程，并使用 wacli send file 命令配合描述性说明，将其直接发送给 WhatsApp 接收方。

在起草后续回复之前，客服人员可在 WhatsApp 历史记录中搜索特定主题或关键词（例如：wacli messages search "invoice" --after 2025-01-01），以找出相关的历史消息。

该工作流将 WhatsApp 消息历史记录同步并回填至本地存储（~/.wacli），以便下游工具可以查询、索引或分析对话数据。