mcpField
W
wacli

wacli

github.com/elizaos生产力19.7k45 次安装今天更新
代码仓库

关于 wacli

wacli 是用于 WhatsApp 的命令行技能，仅在明确要求时发送消息或同步、搜索聊天记录。发送前须确认收件人和消息内容。

主要功能

  1. 01搜索聊天与消息
  2. 02同步及补充历史记录
  3. 03发送文本和文件
  4. 04发送前确认收件人与内容
  5. 05提供 JSON 输出

适用场景

  1. 01查找特定时间段的消息
  2. 02持续同步 WhatsApp 记录
  3. 03向联系人发送已确认的消息
  4. 04向 WhatsApp 群组发送文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/elizaos/eliza --skill wacli

安装后在 Claude Code 中输入/wacli确认已加载。

详细介绍

wacli

仅当用户明确要求你通过 WhatsApp 联系他人，或要求同步／搜索 WhatsApp 历史记录时，才使用 wacli。 普通用户聊天中不要使用 wacli；Otto 会自动路由 WhatsApp 对话。 如果用户正在 WhatsApp 上与你聊天，除非他们要求你联系第三方，否则不要调用此工具。

安全

  • 必须明确指定收件人和消息文本。
  • 发送前确认收件人和消息内容。
  • 如果有任何歧义，请提出澄清问题。

身份验证与同步

  • wacli auth（QR 登录 + 初始同步）
  • wacli sync --follow（持续同步）
  • wacli doctor

查找聊天和消息

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

补全历史记录

  • wacli history backfill --chat <jid> --requests 2 --count 50

发送

  • 文本：wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"
  • 群组：wacli send text --to "[email protected]" --message "Running 5 min late."
  • 文件：wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"

备注

  • 存储目录：~/.wacli（使用 --store 覆盖）。
  • 解析输出时，使用 --json 获取机器可读的输出。
  • 补全历史记录需要手机保持在线；结果仅尽力提供。
  • 日常用户聊天不需要 WhatsApp CLI；它用于联系他人。
  • JID：直接聊天的格式为 <number>@s.whatsapp.net；群组的格式为 <id>@g.us（使用 wacli chats list 查找）。

评论

支持 Markdown