wacli

📱 WhatsApp 命令行消息管理专家

编辑精选

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

收藏
15.3k
安装
3.5k
版本
latest
CLS 安全性认证2026-04-30
点击查看完整报告 >

使用说明

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,用于在命令行环境下发送消息给第三方联系人或搜索/同步历史聊天记录。关键限制:它不用于日常用户聊天——Clawdbot 会自动路由 WhatsApp 对话;仅在用户明确要求联系他人或操作历史记录时触发。

典型工作流
1. 首次认证wacli auth 通过 QR 码登录 WhatsApp 账号

2. 同步数据wacli sync --follow 持续同步聊天记录到本地 ~/.wacli

3. 查找目标wacli chats list --query "姓名或号码" 获取联系人 JID

4. 发送消息wacli send text --to "+号码" --message "内容"

5. 搜索历史wacli messages search "关键词" --after 2024-01-01

输出控制:加 --json 获取机器可解析格式;群组 ID 格式为 数字@g.us

显著优点

  • 自动化友好:纯命令行操作,适合脚本集成和批量消息场景
  • 历史可追溯:支持按日期范围搜索、聊天记录回填(history backfill
  • 灵活发送:支持文本、文件(带 caption)、群组消息
  • 本地存储:聊天数据保存在用户本地 ~/.wacli,非云端托管
  • 安全透明:Skill 本身为纯 Markdown 文档,无隐藏可执行代码

潜在缺点与局限性

  • 外部依赖重:必须自行安装 wacli 二进制(brew 或 go install),Skill 不包含任何功能实现
  • T3 级来源:维护者为社区个人开发者,非企业级背书
  • 手机在线要求:历史回填等功能需要用户手机保持联网
  • 隐私风险:需登录真实 WhatsApp 账号,所有操作对 WhatsApp 官方可见
  • 无实时交互:不适合需要即时双向对话的场景(应使用 Clawdbot 原生 WhatsApp 路由)

适合人群

  • 需要向第三方发送一次性通知/提醒的用户(如告知同事迟到、发送会议资料)
  • 希望备份或搜索历史聊天记录的高级用户
  • 有脚本自动化需求、熟悉命令行环境的开发者
  • 不适合:寻求日常 WhatsApp 聊天体验的普通用户

常规风险

  • 账号安全:登录凭证存储于本地 ~/.wacli,需确保目录权限严格(建议 chmod 700
  • 误发风险:命令行操作缺乏二次确认界面,需严格核对 --to 参数
  • 上游信任:实际功能依赖 steipete/wacli 项目,建议审查其 GitHub 仓库更新
  • 合规注意:自动发送消息可能违反 WhatsApp 商业政策,需获得收件人同意

wacli 内容

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