微信消息本地查询工具 wechat-cli：从安装到玩转 AI 自动化监控

如果你用过「文章同步」机器人，可能会好奇：它是怎么读到微信消息的？答案就是今天要介绍的工具——wechat-cli。本文记录我从安装到实战的全过程，给有同样需求的朋友做个参考。

---

一、它能做什么

wechat-cli 是一个本地微信数据查询 CLI 工具，读的是你电脑上的微信本地数据库，不走任何服务器，完全只读。

功能包括：

• 聊天记录查询（任意群聊/私聊）
• 联系人搜索
• 消息统计（谁发言最多、24小时活跃分布等）
• 关键词搜索（跨群/全局）
• 收藏内容查看
• 未读消息获取

核心特点就一句：纯本地、不上传、只读。

---

二、工作原理

微信电脑端的数据是加密存储的，用的是 SQLCipher 4（AES-256-CBC）。

流程很简单：

本地数据库（加密）
    ↓ init 扫描进程内存，找到密钥
~/.wechat-cli/all_keys.json（密钥文件）
    ↓ 查询时实时解密
wechat-cli history "群名" → JSON 输出

密钥提取的原理：微信运行后，数据库密钥会在进程内存里短暂出现。init 命令就是去扫微信进程的内存，找到匹配的密钥再验证正确性。

**安全说明：**全程只读，不发送、不修改任何数据，不上传网络。

---

三、安装（Windows + Python）

前置要求

• Python ≥ 3.10
• 微信电脑端正常运行（密钥提取需要读进程内存）
• 微信已登录

pip 安装

pip install wechat-cli

验证安装

wechat-cli --version
# 输出: wechat-cli, version 0.2.4

常见问题： Windows 上如果报错 UnicodeEncodeError，先执行：

chcp 65001
$env:PYTHONIOENCODING = "utf-8"

---

四、初始化

必须先运行这一步，且微信要开着：

wechat-cli init

正常情况下会检测到微信数据目录，扫描内存提取密钥，最后显示找到了多少个数据库的密钥。密钥保存在 ~/.wechat-cli/all_keys.json。

微信更新版本后可能需要重新 init

---

五、常用命令

默认输出 JSON，加上 --format text 是人类可读的格式。

看最近会话

wechat-cli sessions --limit 10

返回最近 N 个聊天会话，包含群名、最后一条消息、发送者、时间。

看某个群的历史消息

# 最近20条
wechat-cli history "群名" --limit 20

# 指定时间范围
wechat-cli history "群名" --start-time "2026-04-14 09:00:00" --end-time "2026-04-15 09:00:00"

# 只看图片/文件
wechat-cli history "群名" --type image --limit 10

每条消息包含：发送者、时间戳、消息内容、消息类型。

搜索消息

# 全局搜索
wechat-cli search "关键词" --limit 20

# 指定群内搜索
wechat-cli search "关键词" --chat "群名"

# 搜索文件
wechat-cli search "关键词" --type file

其他命令

wechat-cli members "群名"           # 查看群成员
wechat-cli stats "群名"            # 统计：发送榜、消息类型分布
wechat-cli new-messages            # 增量获取新消息（适合自动化）

消息类型过滤

--type 参数支持：text、image、voice、video、file、link、system。

---

六、用定时任务 + AI 做自动化监控

这是最实用的场景：让 AI 定时抓取群消息，分析重点，发送到微信。

用系统的定时任务（Cron）每3小时触发一次，AI 自动调用 wechat-cli history 获取消息，分析后汇总发送到微信。

prompt 大致这样：

请运行以下命令获取群消息：
  wechat-cli history "技术群A" --limit 15
  wechat-cli history "技术群B" --limit 15
  wechat-cli history "技术群C" --limit 15

分析每个群，提取：
- 重点讨论（技术问题、决策）
- 进展（新进展、结论）
- 待办（谁负责什么事）

生成汇报，格式：
【群名】
- 重点：xxx
- 进展：xxx
- 待办：xxx

只输出汇报内容，每群不超过3条。

同理可以设置每天早上9点自动发日报，汇总前24小时的消息。

---

七、结合 AI 做深度分析

wechat-cli 输出的是结构化 JSON，很适合 AI 处理。可以让 AI：

• 总结某个群的技术讨论要点
• 统计某人在一段时间内的发言频率
• 提取所有待办任务并汇总
• 对比两个群的话题交叉点

直接在 AI 对话框里说：

“总结一下最近「XX群」里关于 XX 协议的技术讨论，列出主要观点和结论”

AI 会自动调用 wechat-cli history 查消息，分析后给你结果。

---

八、注意事项

1. 微信版本更新后可能需要重新 init
2. macOS 需要在系统设置里给终端开「完全磁盘访问」权限
3. 电脑登录了多个微信的话，init 时会让你选
4. 只能查电脑端微信，手机微信的数据不在本机
5. ~/.wechat-cli/all_keys.json 是解密密钥，保管好不要外传

---

九、总结

wechat-cli 解决的核心问题就是：让 AI 读到你电脑上的微信消息。全程本地操作，数据不触网，用起来比较安心。

配合定时任务和 AI 分析能力，可以实现自动化的工作流监控，省去人工频繁翻群聊的麻烦。

相关链接：

• GitHub: https://github.com/huohuoer/wechat-cli
• PyPI: pip install wechat-cli
• 参考项目: wechat-decrypt（核心解密逻辑）

---

本文使用 wechat-cli v0.2.4 + Python 3.10 + Windows 11 环境测试。