whatsapp

想在終端管理WhatsApp消息？whatsapp-cli是基於WhatsApp Web多設備協議的獨立命令列界面。通過x-cmd一鍵安裝，終端輕鬆管理WhatsApp。

Language	Go
Homepage	https://github.com/vicentereig/whatsapp-cli

容器調用: ^{實驗性功能}

1. 使用 docker 模組自動拉取基礎鏡像，並在首次執行時根據需求重構為一個可直接運行的完整軟件鏡像。
2. 在後續運行中，命令會基於已構建好的鏡像快速啓動容器，實現秒級響應。
3. 所有操作均在容器內部完成，與本地系統完全隔離，無需任何本地依賴，安全、乾淨且不留痕跡。
4. 當因軟件版本或依賴發生變化需重構鏡像時，會充分利用 Docker 鏡像構建的緩存機制，最大限度地複用已下載的依賴與構建成果，大幅縮短重建耗時。

該功能仍在測試中，使用過程中如有問題，歡迎在 X-CMD 社區 留言反饋。

x docker alpine whatsapp-cli

xd alp whatsapp-cli

---

x install whatsapp

/go	go install github.com/vicentereig/whatsapp-cli@latest
darwin/brew	brew install vicentereig/tap/whatsapp-cli

WhatsApp CLI：基於 WhatsApp Web 多設備協議的命令列工具

WhatsApp CLI 是一個基於 WhatsApp Web 多設備協議的獨立命令列界面工具。所有命令都返回結構化的 JSON 輸出，非常適合自動化腳本、AI 工具集成和數據分析。

核心特點

特點	説明
零依賴	單二進制文件（21MB），無需運行時
JSON 輸出	所有命令返回結構化 JSON，易於解析
持久會話	通過二維碼認證一次，自動重連約 20 天
本地存儲	SQLite 資料庫，無雲端依賴
完整消息功能	發送、接收、搜索消息；管理聯繫人和聊天
羣組支持	在羣組聊天中發送/接收消息

安裝

Homebrew（推薦）

brew install vicentereig/tap/whatsapp-cli

從源碼構建

go install github.com/vicentereig/whatsapp-cli@latest

下載預構建二進制文件

# Linux (x86_64)
curl -LO https://github.com/vicentereig/whatsapp-cli/releases/latest/download/whatsapp-cli-linux-amd64.tar.gz
tar -xzf whatsapp-cli-linux-amd64.tar.gz
sudo mv whatsapp-cli-linux-amd64 /usr/local/bin/whatsapp-cli

快速開始

1. 首次認證

whatsapp-cli auth

• 終端顯示二維碼
• 打開手機 WhatsApp → 設置 → 已關聯設備 → 關聯設備
• 掃描二維碼
• 會話保存到 ./store/whatsapp.db

2. 同步消息

# 在後台或單獨終端運行
whatsapp-cli sync
# 按 Ctrl+C 停止同步

3. 基本操作

# 列出聊天
whatsapp-cli chats list --limit 10

# 搜索聯繫人
whatsapp-cli contacts search --query "John"

# 發送消息
whatsapp-cli send --to 1234567890 --message "Hello from CLI!"

# 搜索消息
whatsapp-cli messages search --query "meeting"

常用命令

命令	説明
auth	通過二維碼認證
sync	同步消息（保持連接接收實時消息）
chats list	列出聊天列表
contacts search	搜索聯繫人
send	發送消息
messages search	搜索消息歷史
version	查看版本

AI 集成

由於所有輸出都是結構化 JSON，非常適合與 AI 工具集成：

# 獲取最近聊天並傳遞給 AI 處理
whatsapp-cli chats list --limit 5 | jq '.data.chats[].name'

# 搜索特定消息並分析
whatsapp-cli messages search --query "project" | jq '.data.messages[].text'

數據模型

• 會話資料庫: ./store/whatsapp.db - 存儲認證會話
• 消息資料庫: ./store/messages.db - 存儲消息歷史
• 格式: SQLite，可使用標準 SQL 工具查詢

適用場景

• 自動化 WhatsApp 消息發送（如 CI/CD 通知）
• 批量導出和分析聊天記錄
• 將 WhatsApp 集成到 AI 工作流中
• 構建基於 WhatsApp 的自定義應用
• 通過命令列管理 WhatsApp 而不打開手機

來源：

https://github.com/vicentereig/whatsapp-cli