什么是 wacli？

wacli 是一款强大的实用程序，旨在让 AI 代理和开发人员能够直接从终端与 WhatsApp 平台进行交互。与标准聊天界面不同，该工具专注于程序化交互，例如发送自动化通知、文件共享和深度历史查询。通过 Openclaw Skills 集成此功能，代理可以联系外部联系人或检索历史数据，而无需在图形应用中进行人工干预。

该工具优先考虑安全性和明确意图，确保仅在特别请求时才发送消息。它支持 WhatsApp 数据的本地化同步，是需要对大型消息存档执行复杂查询或通过脚本管理群组通信的开发人员的高效选择。

下载入口:https://github.com/openclaw/skills/tree/main/skills/rafay0313/tt

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

wacli 应用场景

• 向外部接收者发送自动文本通知或文档。
• 在广泛的 WhatsApp 历史记录中搜索发票或日期等特定关键词。
• 回填并存档聊天历史记录，用于数据分析或审计。
• 通过脚本化的命令行操作管理群组聊天通信。
• 通过 Openclaw Skills 将 WhatsApp 推广集成到复杂的多步工作流中。

1. 通过运行 auth 命令并使用移动设备扫描二维码进行身份验证。
2. 该工具在 ~/.wacli 目录中初始化本地数据库，以存储聊天元数据和消息历史记录。
3. 触发持续或单次同步，以确保本地数据与 WhatsApp 服务器匹配。
4. 用户或代理使用通过聊天列表命令检索到的 JID（Jabber ID）识别特定接收者。
5. 发布发送文本或文件的命令，然后通过经过身份验证的会话进行调度。

wacli 配置指南

使用 Homebrew 安装 wacli：

brew tap steipete/tap
brew install wacli

或者，通过 Go 安装：

git install github.com/steipete/wacli/cmd/wacli@latest

初始化您的会话：

wacli auth

wacli 数据架构与分类体系

该技能在本地组织数据，以便在 Openclaw Skills 环境中进行快速搜索和检索。

name: wacli
description: Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
homepage: https://wacli.sh
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["wacli"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/wacli","bins":["wacli"],"label":"Install wacli (brew)"},{"id":"go","kind":"go","module":"github.com/steipete/wacli/cmd/wacli@latest","bins":["wacli"],"label":"Install wacli (go)"}]}}

wacli

Use wacli only when the user explicitly asks you to message someone else on WhatsApp or when they ask to sync/search WhatsApp history. Do NOT use wacli for normal user chats; Clawdbot routes WhatsApp conversations automatically. If the user is chatting with you on WhatsApp, you should not reach for this tool unless they ask you to contact a third party.

Safety

• Require explicit recipient + message text.
• Confirm recipient + message before sending.
• If anything is ambiguous, ask a clarifying question.

Auth + sync

• wacli auth (QR login + initial sync)
• wacli sync --follow (continuous sync)
• wacli doctor

Find chats + messages

• wacli chats list --limit 20 --query "name or number"
• wacli messages search "query" --limit 20 --chat
• wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31

History backfill

• wacli history backfill --chat --requests 2 --count 50

Send

• Text: wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"
• Group: wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."
• File: wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"

Notes

• Store dir: ~/.wacli (override with --store).
• Use --json for machine-readable output when parsing.
• Backfill requires your phone online; results are best-effort.
• WhatsApp CLI is not needed for routine user chats; it’s for messaging other people.
• JIDs: direct chats look like @s.whatsapp.net; groups look like @g.us (use wacli chats list to find).