wacli

📱 WhatsApp 命令行消息管理专家

编辑精选

基于开源 wacli 工具的 WhatsApp 命令行管理方案,支持消息发送、历史同步与搜索,实现企业级通信自动化。

收藏
15.5k
安装
3.6k
版本
latest
CLS 安全性认证2026-05-05
点击查看完整报告 >

使用说明

wacli 是一款专为命令行环境设计的 WhatsApp 管理工具 Skill,它通过封装开源 wacli CLI 工具的功能,为用户提供发送消息、同步历史记录和搜索聊天内容的自动化能力。该 Skill 本身为纯文档型资产,主要提供详细的命令使用指南和安全操作规范,实际功能执行完全依赖用户本地安装的 wacli 二进制文件。

核心用法涵盖完整的 WhatsApp 工作流管理。首次使用需通过 wacli auth 完成 QR 码登录和初始同步,建立本地数据缓存。日常操作中,用户可使用 wacli sync --follow 保持实时同步,利用 wacli chats list 查询联系人,或通过 wacli messages search 基于关键词、时间范围精准检索历史消息。对于消息发送,支持文本消息(wacli send text)和文件传输(wacli send file),既可用于一对一通信(格式为 <number>@s.whatsapp.net),也支持群组消息(格式为 <id>@g.us)。此外,wacli history backfill 功能允许按需回填特定聊天的历史记录。

显著优点体现在安全性与自动化能力的平衡。作为纯 Markdown 文档型 Skill,它不包含任何可执行代码,无注入漏洞或系统破坏性命令风险,所有操作均通过透明可审计的 CLI 指令完成。命令行界面适合批量处理和脚本集成,企业用户可将 WhatsApp 通信集成到现有工作流,如自动发送通知、备份聊天记录或构建客服机器人。数据本地存储(默认 ~/.wacli)确保敏感信息不离线,符合隐私合规要求。

潜在局限性主要包括技术门槛和依赖风险。用户需自行安装配置 wacli CLI 工具(支持 Homebrew 或 Go 安装),并具备一定的命令行操作基础。该 Skill 明确不适用于普通用户聊天场景,仅设计用于向第三方发送消息或历史记录管理。由于依赖外部工具,功能可用性受 wacli 项目维护状态影响,且 WhatsApp 官方 API 变更可能导致兼容性问题。此外,历史回填功能需要手机保持在线,且结果为尽力而为,不保证完整性。

适合目标群体主要是技术背景较强的用户和企业 IT 团队。开发者可利用其构建自动化通知系统,将 WhatsApp 集成到 CI/CD 流程或监控告警中;运营团队可通过批量消息功能进行客户触达;系统管理员可利用搜索和同步功能实现合规性备份。不适合普通终端用户日常聊天,也非低代码/无代码场景的理想选择。

使用风险需重点关注账户安全和数据隐私。wacli 工具需要访问完整的 WhatsApp 账户数据,包括聊天记录和联系人信息,虽然 Skill 本身不收集数据,但第三方工具的安全性需用户自行评估。发送消息前必须严格验证接收方号码(JID),避免误发敏感信息。依赖项更新滞后可能带来安全漏洞,建议定期通过官方渠道(brew 或 go install)更新 wacli。此外,频繁操作可能触发 WhatsApp 的反垃圾邮件机制,导致账户限制。

安全解读

核心用法

wacli 是一个封装 WhatsApp CLI 工具的 Skill,用于向第三方发送消息或同步/搜索 WhatsApp 历史记录。不适用于用户与 AI 的常规对话(Clawdbot 已自动路由)。

主要功能

| 场景 | 命令示例 |
|------|----------|
| 首次登录 | `wacli auth`(扫码 QR 码) |
| 持续同步 | `wacli sync --follow` |
| 查找聊天 | `wacli chats list --limit 20 --query "姓名或号码"` |
| 搜索消息 | `wacli messages search "关键词" --chat <jid>` |
| 发送文本 | `wacli send text --to "+14155551212" --message "内容"` |
| 发送文件 | `wacli send file --to "..." --file /path/file.pdf --caption "说明"` |
| 历史补全 | `wacli history backfill --chat <jid> --requests 2 --count 50` |

显著优点

  • 纯文档封装:Skill 本身不含可执行代码,仅提供标准 CLI 调用说明,降低注入风险
  • 强制确认机制:文档明确要求「显式指定收件人+消息内容」和「发送前二次确认」,防止误操作
  • 灵活查询:支持按时间范围、聊天对象、关键词多维检索历史消息
  • 本地存储:数据默认保存在 ~/.wacli,用户可控

潜在缺点/局限性

  • 外部依赖风险:核心功能依赖独立的 wacli 二进制工具(需通过 Homebrew 或 Go 安装),不在 Skill 内部
  • 需手机在线:历史补全功能要求用户手机保持联网,且结果为「尽力而为」
  • JID 格式门槛:群组 ID 格式为 <id>@g.us,个人为 <number>@s.whatsapp.net,需先通过 chats list 查询
  • 非双向交互:仅支持「发送/搜索」,不处理接收消息的实时推送

适合人群

  • 需要向第三方自动发送 WhatsApp 消息的开发者/自动化用户
  • 需要备份、审计或检索 WhatsApp 历史记录的个人或团队
  • 不适合:仅想与 AI 聊天的普通用户(此场景已自动处理)

常规风险

  • 供应链安全:wacli 工具作者 Peter Steinberger 为知名开发者,但仍需关注上游安全通告
  • 数据残留~/.wacli 目录长期保存聊天记录,需定期手动清理
  • 社交工程误发:虽然强制确认,但用户仍需仔细核对收件人号码,避免错发敏感信息

wacli 内容

手动下载zip · 1.4 kB
SKILL.mdtext/markdown
请选择文件