大家好，我是苍一，一个干了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，安装命令：

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编程