分享一个微信聊天记录读取、搜索和导出工具,还支持 AI“接管”

最近看到一个挺有意思的开源项目:wx-cli。它不是普通的微信聊天记录导出工具,而是直接读取 Mac 微信本地数据,把微信里的聊天记录、联系人、群聊以及图片、语音、视频等内容变成可以被命令行、程序甚至 AI Agent 使用的数据。目前自测下来没有封号风险。

项目地址:

简单理解,就是给微信加了一层“数据接口”。以前想从微信聊天记录里找东西,基本只能打开微信自己翻;有了 wx-cli 之后,可以直接用关键词搜索,比如搜索某个人、某个群,或者搜索某句话出现在哪些聊天里。项目还支持按照时间、联系人、群聊、消息类型等条件查询。

更有意思的是,它不单单只是查看历史消息。

wx-cli 还支持实时监听新消息。也就是说,历史聊天可以查,刚刚收到的新消息也可以持续监听,然后通过 SSE 实时推送给其他程序或者 AI Agent。

这就让它的玩法一下子多了起来。

比如可以让 AI 帮你从聊天记录里找出以前答应过别人的事情,整理某个客户的聊天内容,搜索某个项目之前讨论过的方案,甚至根据一段时间的微信聊天自动生成日报、客户纪要或者项目进展。

项目作者甚至直接把它定位成一个“微信之上的 Agent 能力层”,而不是单纯的聊天记录导出工具。

和 AI Agent 配合起来更有意思

wx-cli 自带了 Agent Skill,目前可以让 Claude Code、Codex、Cursor 等 Agent 直接理解它的能力。

安装 Skill 后,Agent 就可以按照项目提供的接口去查询和订阅微信数据,而不用每次都手动告诉 AI wx-cli 的命令和数据格式。

这也是我觉得这个项目比较有意思的地方。

以前我们说“让 AI 读取微信”,通常想到的是把聊天记录导出来,再丢给 AI 分析。wx-cli 的思路则更进一步:让微信本身成为 AI 可以持续访问的数据源。

例如:

“帮我找一下张三上个月提到的那个项目。”

“把最近一周客户提出的问题整理一下。”

“找出我在微信里答应别人、但还没有完成的事情。”

“把某个项目相关的聊天记录按照时间整理出来。”

这些事情理论上都可以建立在 wx-cli 提供的数据能力之上。

功能其实挺完整

目前项目支持的功能已经比较多,包括联系人查询、会话列表、聊天记录搜索、全文搜索、聊天记录导出,以及图片、语音、视频等媒体处理。

聊天记录可以导出成 TXT 或 JSON,也可以通过 REST API 提供给其他程序使用。项目还支持本地 HTTP 服务和实时事件流,因此不仅 AI Agent 可以使用,自己写自动化程序也可以接进去。

另外还有一个比较实用的功能,就是隐私过滤,可以指定隐藏某些联系人、群聊、标签或者群成员,让这些内容不出现在查询和订阅结果中。

不过使用门槛也不低

这个项目目前主要针对 Apple Silicon Mac,要求 macOS,并且微信版本需要 4.1.7 及以上。

因为微信数据库本身是加密的,所以第一次使用需要处理数据库密钥。项目提供了 key extract 等方式获取密钥,然后再解密本地数据库。

这里也是它和普通微信导出工具最大的区别之一——它实际上是在直接处理微信本地数据库,因此权限和系统环境要求会高一些。

按照项目目前的说明,使用 key extract 需要关闭 SIP,同时还需要配置 DevToolsSecurity、开发者组以及 Xcode Command Line Tools。

所以如果只是想偶尔导出一次聊天记录,我觉得没必要折腾这个;但如果你本身就在用 Mac,而且对 AI Agent、个人知识库、自动化、微信数据分析这些东西感兴趣,那这个项目就比较值得研究。

我觉得它真正有意思的地方并不是“可以把微信聊天记录导出来”,而是它提供了一种思路:把原本封闭在微信里的个人数据,变成 AI 可以搜索、理解和持续使用的数据源。

当然,微信聊天记录里面往往包含大量隐私信息。wx-cli 官方也明确提醒它会处理数据库密钥、解密后的聊天消息和媒体文件,所以如果要尝试,最好只在自己的 Mac 和自己的微信数据上使用,同时注意本地文件和 API 服务的访问权限。