wacli 综合评估
核心用法
wacli 是一款 WhatsApp 命令行工具,专为需要通过代码与 WhatsApp 生态交互的高级用户设计。核心功能分为三大模块:授权同步(wacli auth QR登录、wacli sync --follow 实时同步)、消息检索(wacli chats list 查找聊天、wacli messages search 按关键词/时间范围搜索)、消息发送(wacli send text/file 向个人或群组发送文本/附件)。支持JID格式识别(个人 <number>@s.whatsapp.net,群组 <id>@g.us),数据默认存储于 ~/.wacli。
显著优点
- 自动化友好:纯CLI设计,配合
--json输出便于脚本集成 - 功能完整:涵盖授权、同步、搜索、历史回填、发送全流程
- 群组支持:原生支持群组JID,适合团队通知场景
- 灵活安装:提供Homebrew和Go两种安装渠道
潜在缺点与局限性
- 非常规工具:明确禁止用于"日常用户聊天",使用场景受限
- 依赖手机在线:历史回填功能需要手机保持联网,且结果为"尽力而为"
- 隐私敏感:本地存储WhatsApp数据,需自行保障
~/.wacli目录安全 - 授权复杂:首次使用需QR码扫描,流程较普通API繁琐
适合人群
- 开发者需要自动化发送WhatsApp通知(如服务器告警、预约提醒)
- 需要批量搜索/导出个人WhatsApp历史记录的高级用户
- 已有WhatsApp Business需求但希望自托管方案的技术团队
常规风险
- 误发风险:CLI工具缺乏二次确认UI,脚本错误可能导致消息误发
- 账号安全:非官方客户端,存在被WhatsApp封禁风险(虽作者steipete为知名开发者)
- 数据泄露:本地存储的认证数据若未加密,物理访问即可获取聊天记录
- 合规问题:自动发送商业消息需遵守WhatsApp Business政策,个人账号批量发送可能违规