wacli 是一个专为开发者和管理员设计的命令行工具，用于通过 WhatsApp API 发送消息、搜索和同步聊天记录。它不适用于普通用户的日常聊天场景，而是作为 Clawdbot 系统的底层接口，在用户需要主动联系第三方或进行历史记录检索时调用。该工具强调安全性与可控性，要求明确指定接收者并确认消息内容后方可发送，避免误操作。所有数据操作均基于 WhatsApp Business API 协议实现，支持文本、文件等多种消息类型，并能处理个人对话与群组通信。配置信息默认存储在 `~/.wacli` 目录中，可通过 `–store` 参数自定义路径。
核心功能特点
- 支持通过命令行发送文本消息和文件到指定 WhatsApp 联系人或群组
- 提供聊天记录搜索与同步功能，可按时间范围、关键词过滤结果
- 具备身份验证（QR 扫码登录）与持续同步机制，确保数据实时更新
- 可执行历史记录回填操作，用于补全缺失的过往消息
- 输出格式支持 JSON，便于自动化脚本解析处理
- 内置健康检查命令 `doctor`，诊断连接状态与配置完整性
适用场景
wacli 主要面向需要批量管理 WhatsApp 通信的企业管理员、客服系统或自动化流程开发者。例如，当客户支持团队需向大量用户发送通知时，可通过脚本调用 wacli 实现定时群发；又如法务部门在处理纠纷时，可利用其搜索功能快速定位特定时间段内的沟通记录作为证据。此外，对于依赖 WhatsApp 进行业务协作的组织而言，该工具能集成进内部工作流，自动触发提醒或归档重要对话。需要注意的是，由于涉及隐私与安全策略，使用 wacli 必须获得明确授权，且不得用于个人社交聊天。其设计初衷是增强 WhatsApp 在企业级应用中的可操作性与可追溯性，而非替代普通用户的即时通讯体验。