微信聊天记录也能被 AI 读取了！这个开源工具让数据全部本地化

你可能遇到过这种情况：想搜索半年前某条重要的微信消息，翻遍聊天记录却怎么也找不到。或者想分析一下某个群聊的活跃度，却只能靠人工数数。

现在，一个叫 wechat-cli 的开源工具解决了这个问题——它可以让你在终端里直接查询本地微信的所有数据，而且专为 AI Agent 设计。

零配置安装，数据永不离开本机

wechat-cli 的安装非常简单，一条命令搞定：

npm install -g @canghe_ai/wechat-cli

初始化只需要运行一次：

sudo wechat-cli init

工具会自动检测微信数据目录、提取加密密钥，所有配置保存在 ~/.wechat-cli/。最重要的是，所有数据解密都在本地完成，数据永远不会离开你的电脑。

11 个命令，覆盖你所有查询需求

安装完成后，你可以用命令行做这些事情：

查看最近聊天：

wechat-cli sessions --limit 20

读取某个人的聊天记录：

wechat-cli history"张三" --limit 50

搜索关键词（支持指定聊天）：

wechat-cli search "项目deadline" --chat "团队群"

查看未读消息：

wechat-cli unread

获取新消息（适合自动化任务）：

wechat-cli new-messages

群成员列表：

wechat-cli members "产品群"

聊天统计分析：

wechat-cli stats "团队群" --format text

返回结果包括：总消息数、各类型消息占比、发送者排名、24小时活跃分布。

为什么说它是 AI Agent 的神器？

wechat-cli 最有意思的设计是：所有命令默认输出 JSON 格式，专门为 AI 工具调用优化。

你只需要在 AI 的配置文件里加一段说明：

## WeChat CLI-`wechat-cli sessions --limit 10` — 最近聊天-`wechat-cli history "NAME" --limit 20` — 聊天记录-`wechat-cli search "KEYWORD" --chat "GROUP"` — 搜索消息-`wechat-cli unread` — 未读消息

之后你就可以用自然语言让 AI 帮你查微信了：

• “帮我查查上周团队群里关于项目deadline的消息”
• “谁是这个月在群聊里发消息最多的人？”
• “检查一下有没有未读的重要消息”

这意味着你的 AI 助手可以访问你所有的微信上下文，帮你做信息检索、总结分析。

支持多账号、数据导出、收藏夹查询

除了聊天记录查询，wechat-cli 还支持：

• 联系人搜索：按姓名模糊匹配，显示昵称、微信号、个人简介
• 收藏夹查询：查看你保存的所有内容
• 数据导出：支持 Markdown 或纯文本格式，可按时间范围过滤
• 多账号切换：本地登录多个微信也能正常使用

安全细节

需要注意的是，macOS 上首次初始化需要 sudo 权限来读取微信的加密密钥。如果遇到权限问题，工具会自动尝试重新签名微信应用（不影响账号安全），按提示操作即可。

适合谁用？

• 需要把微信聊天记录接入知识库的人
• 想分析群聊活跃度或消息分布的情况
• 使用 AI Agent 并希望它能访问微信上下文的高级用户
• 重视隐私、想要本地化数据管理的开发者

目前主要支持 macOS arm64，其他平台可以用 pip 方式安装。

GitHub：freestylefly/wechat-cli^[1]

相关阅读：

• Claude Code 全面升级：连接器生态与智能体架构再进化^[2]
• YC CEO Garry Tan：Thin harness, fat skills^[3]

引用链接