wacli¶
Skill 简介¶
wacli 是一个基于命令行接口（CLI）的工具，旨在帮助开发者和高级用户通过 WhatsApp 发送消息、搜索聊天记录以及同步 WhatsApp 历史数据。与面向普通用户日常聊天的 WhatsApp 客户端不同，wacli 主要面向开发者或自动化场景，例如通过脚本自动发送消息、批量处理聊天记录等。它利用 WhatsApp 的 API 功能，使开发者能够以编程方式与 WhatsApp 进行交互，从而实现更复杂和定制化的操作。
wacli 的设计初衷并非用于日常的 WhatsApp 聊天，而是为了满足那些需要通过命令行或脚本与 WhatsApp 进行交互的特殊需求。例如，开发者可能需要自动发送通知、批量发送消息，或是在开发过程中进行聊天记录的搜索和同步。wacli 提供了简洁而强大的命令集，使得这些操作变得高效而可靠。
主要功能¶
wacli 提供了多种核心功能，以下是其中几个关键功能的详细介绍：
-
消息发送：wacli 支持发送文本消息、群组消息以及文件消息。开发者可以通过简单的命令将消息发送到指定的联系人或群组。例如，使用以下命令可以向指定号码发送文本消息：
bash wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"
发送群组消息和文件消息的命令也类似，只需指定相应的参数即可。 -
聊天记录搜索：wacli 允许用户根据关键词搜索聊天记录，并可以指定时间范围和聊天对象。例如，以下命令将在指定聊天中搜索包含“invoice”的消息，时间范围为2025年1月1日至2025年12月31日：
bash wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31 --chat <jid> -
聊天记录同步：wacli 提供了持续同步功能，可以实时跟踪 WhatsApp 聊天记录的变化。通过以下命令可以启动持续同步：
bash wacli sync --follow -
身份验证与初始同步：在使用 wacli 之前，需要进行身份验证和初始同步。可以通过扫描二维码的方式进行登录，并进行首次同步：
bash wacli auth -
聊天记录回填：wacli 支持回填聊天记录，这对于需要补全历史数据或进行数据恢复的场景非常有用。需要注意的是，回填操作需要手机在线，并且结果为尽力而为：
bash wacli history backfill --chat <jid> --requests 2 --count 50 -
医生模式：wacli 提供了“医生模式”，用于诊断和修复可能存在的问题：
bash wacli doctor
使用场景¶
-
自动化消息发送：在开发过程中，开发者可能需要定期向特定联系人或群组发送通知或报告。wacli 可以通过脚本实现自动化消息发送，节省人力和时间。
-
聊天记录分析：对于需要分析 WhatsApp 聊天数据的应用场景，wacli 提供了强大的搜索和同步功能。开发者可以编写脚本，定期获取聊天记录并进行数据分析。
-
数据备份与恢复：wacli 的回填功能可以用于备份 WhatsApp 聊天记录，并在需要时进行恢复。这对于数据安全和灾难恢复非常重要。
-
集成第三方服务：开发者可以将 wacli 集成到其他服务或应用中，实现更复杂的自动化流程。例如，将 WhatsApp 消息与邮件系统、CRM 系统等集成，实现信息的无缝流转。
-
开发测试：在开发 WhatsApp 相关的应用或服务时，wacli 可以作为测试工具，模拟用户行为，测试应用的各项功能。
如何使用¶
安装¶
wacli 支持通过多种方式安装，以下是两种主要的方法：
-
通过 Homebrew 安装：
bash brew install steipete/tap/wacli -
通过 Go 安装：
bash go install github.com/steipete/wacli/cmd/wacli@latest
配置¶
在使用 wacli 之前，需要进行身份验证和初始同步。可以使用以下命令启动身份验证流程：
wacli auth
按照提示扫描二维码进行登录，登录成功后，wacli 将自动进行初始同步。
前置条件¶
- 需要一个有效的 WhatsApp 账号。
- 需要在手机上安装 WhatsApp，并保持手机在线状态。
- 需要确保网络连接正常。
示例¶
示例 1：发送文本消息¶
wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"
示例 2：搜索聊天记录¶
wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31 --chat <jid>
总结¶
wacli 是一个功能强大的 WhatsApp CLI 工具，专为开发者设计，提供了丰富的功能和灵活的接口。通过 wacli，开发者可以实现自动化消息发送、聊天记录搜索与同步、数据备份与恢复等多种操作，极大地提升了开发效率和应用的功能性。wacli 适用于那些需要与 WhatsApp 进行深度集成的应用场景，无论是自动化流程、数据分析，还是第三方服务的集成，wacli 都能提供可靠的支持。对于那些希望在 WhatsApp 平台上进行创新开发的开发者来说，wacli 是一个不可或缺的工具。