核心用法
wacli 是一款基于命令行的 WhatsApp 客户端，专为开发者与高级用户设计，支持直接发送消息、搜索对话历史及同步聊天记录。与常规 WhatsApp 网页版或桌面应用不同，它无需图形界面即可运行，便于集成到脚本、CI/CD 流水线或自动化任务中。
主要功能模块：
- 身份认证：通过
wacli auth扫描二维码完成登录，支持wacli sync --follow持续同步消息 - 对话管理：
wacli chats list查找联系人/群组，wacli messages search支持按关键词、时间范围筛选 - 消息发送：支持纯文本 (
send text)、文件 (send file) 发送至个人或群组 - 历史补全：
wacli history backfill可回填早期消息（需手机在线）
显著优点
- 完全 CLI 驱动，适合服务器/无头环境部署
- 支持 JSON 输出 (
--json)，便于与jq等工具链集成 - 消息搜索支持时间范围过滤，比官方客户端更灵活
- 开源工具，社区可审计
潜在局限与风险
- 非官方实现：基于 WhatsApp Web 非官方协议，存在账号被封禁风险
- 同步依赖：消息回填与实时同步要求手机保持在线
- 无端到端加密保证：CLI 存储的密钥与消息明文落盘于
~/.wacli - 人机验证：新设备登录可能触发 WhatsApp 安全审查
- 适用边界明确：工具文档强调「不用于正常用户聊天」，仅限第三方消息发送或历史检索
适合人群
- 需要将 WhatsApp 集成到自动化工作流的开发者
- 需要批量导出或搜索历史消息的数据分析师
- 客服系统需要对接 WhatsApp 的技术团队
常规风险
- 账号限制：WhatsApp 对非官方客户端有明确的政策限制，过度自动化可能导致临时或永久封号
- 隐私泄露：本地存储的消息数据库若未加密，存在设备丢失/入侵后的数据暴露风险
- 同步失败：手机离线时无法完成消息同步或历史回填