—title: 微信 cli 开源了，终于不用爬楼了翻消息了！
date: 2026-04-27 19:41:22
summary: title: 微信 cli 开源了，终于不用爬楼了翻消息了。date: 2026-04-27 19:41:22 summary:
tags:
- Claude Code
- Hermes
- AI Agent
- 终端
- Git
- 知识库
- 开源
- macOS
- 微信转载
categories: - 转载—
大家好，我是苍一，一个干了13年的后端开发，正在探索AI编程，从产品到开发的全生命周期最佳实践，如果您感兴趣，欢迎关注👇，看我如何自我革命。
微信群一多，消息根本追不上。几十个群，每天几万条，99+红点刷屏。有价值的信息被灌水淹没，事后想翻根本找不到。
有人做了一个开源工具 wechat-cli，用命令行操作本地微信数据，全程跑在你自己电脑上，不经过任何第三方服务器。
wechat-cli 是什么
一个微信命令行工具。装好之后，在终端里敲命令就能查看会话、搜索消息、导出聊天记录、拉群成员列表、统计活跃度。数据全在本地，零封号风险。
11个命令覆盖高频场景
wechat-cli 目前支持11条命令：
init – 初始化环境，自动提取本地微信数据库密钥
sessions – 列出最近聊天会话
history – 查看指定聊天的记录，支持分页和时间范围过滤
search – 全局搜索消息，可以按聊天对象和消息类型筛选
contacts – 搜索联系人、查看联系人详情
members – 列出群成员信息
stats – 聊天统计分析，包括活跃度排名、消息类型占比、24小时分布图
export – 导出聊天记录为 Markdown 或纯文本
favorites – 查看微信收藏内容
unread – 查看未读会话
new-messages – 增量拉取新消息
所有命令默认输出 JSON 格式。
为什么默认输出 JSON
因为 wechat-cli 的设计目标就是给 AI Agent 用的。你不需要自己去敲命令，让 AI 来调就行。
比如你在 Claude Code 里说”总结一下某某群最近的10条消息”，Agent 会自动执行 wechat-cli history "某某群" --limit 10 --format text，拿到结果后帮你做总结。
安装和使用
wechat-cli 已发布到 npm，安装命令：
1 | `npm install -g wechat-cli` |
安装完成后运行 wechat-cli init，工具会自动检测本地微信数据库并提取密钥。之后就能直接用其他命令了。
macOS 和 Windows 都支持。具体细节可以去 GitHub 仓库看文档，也可以直接让你的 Agent 读取 README 自行安装配置。
GitHub 地址：https://github.com/freestylefly/wechat-cli
实际能拿来干嘛
1️⃣ 群消息快速回顾
加了太多群，不可能每个都看。用 history 拉取某个群的最近消息，配合 AI 做摘要，一分钟了解一个群今天聊了什么。
2️⃣ 聊天记录导出备份
微信本身没有批量导出功能。wechat-cli 的 export 命令可以把指定聊天的记录导出为 Markdown 文件。配合飞书 cli 还能直接上传到飞书文档，方便存档和分享。
3️⃣ 联系人和群成员管理
contacts 搜索联系人，members 查群成员列表。适合需要整理人脉或做社群运营的场景。
4️⃣ 消息统计分析
stats 命令能看到谁最活跃、消息类型分布、24小时内的活跃时段。对社群运营者来说，这些数据可以直接用来做群管理决策。
5️⃣ 接入 Agent 工作流
wechat-cli 可以集成到 Claude Code、OpenClaw、QClaw 等 Agent 框架中。有人把它接上 OpenClaw 和微信 Bot 之后，直接在微信群里用自然语言提问，Agent 自动调 wechat-cli 查数据再回复。
6️⃣ 收藏内容管理
微信收藏没有搜索和分类功能，东西多了很难找。favorites 命令把收藏内容拉出来，交给 AI 做分类整理。
数据安全
所有数据都在你本地，wechat-cli 不上传任何信息到外部服务器。如果你更在意隐私，可以接本地大模型来处理，做到数据完全不出本机。
许可协议
Apache License 2.0 开源，仅供个人学习使用。
GitHub 地址：https://github.com/freestylefly/wechat-cli
如果嫌文章太长、怕后面走丢，可以关注下面的ima知识号，让这篇文章成为你的知识顾问，随时随地等候你的提问。
知识号中内容会以笔记形式分享，可以根据大家反馈和实测情况，实时更新，保证最新方案的稳定、可用。
【ima知识库】苍一AI编程
💬 本文评论区已开启，但暂无读者留言。
本文转载自微信公众号，如有侵权请联系删除。
- 标题:
- 作者: lxiol
- 创建于 : 2026-04-27 19:41:22
- 更新于 : 2026-04-29 20:21:28
- 链接: https://blog.lxiol.cn/2026/04/27/微信-cli-开源了终于不用爬楼了翻消息了/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。