Chatlog 是一款开源的微信聊天记录本地管理工具。它从电脑版微信的本地数据库文件中读取聊天数据并自动解密,再通过终端界面、命令行与 HTTP API 三种方式提供查询和导出,支持 Windows 与 macOS,覆盖微信 3.x 与 4.0,适合想把聊天记录留在自己设备里、按需检索整理或交给 AI 助手分析的用户。

聊天数据在本地,但不容易取出来
电脑版微信会把聊天记录存在本机的加密数据库里,自带的搜索和备份能力对历史数据来说相当有限。Chatlog 做的事情是读取这份本来就保存在用户设备上的数据:先用数据密钥解密数据库,再把消息、联系人、群聊和会话整理成可查询的结构。HTTP 服务默认监听本机地址 127.0.0.1,查询过程都在本地完成。
三种使用方式:界面、命令行与本地服务
直接运行 chatlog 会进入终端交互界面,菜单里依次完成「获取数据密钥」「解密数据」「开启 HTTP 服务」,不想敲命令的用户跟着菜单走即可。习惯脚本化的用户则可以用子命令一步步执行:
chatlog key- :从已登录的微信中获取本地数据密钥
chatlog decrypt- :解密本地数据库文件,生成可查询的数据
chatlog server- :启动 HTTP 服务,对外提供 API 与 MCP 接口
chatlog key # 获取微信数据密钥
chatlog decrypt # 解密本地数据库文件
chatlog server # 启动 HTTP 服务(默认 127.0.0.1:5030)
查询与导出:一个接口走完
核心接口是 GET /api/v1/chatlog,用 time 指定日期或日期范围、talker 指定聊天对象,再配合 limit 与 offset 分页。format 参数支持 json、csv 和纯文本三种输出,想要备份归档时按联系人批量拉一遍就是一次导出。任何能发 HTTP 请求的语言都能调用,做消息统计、生成年度报告或接入自己的知识库都在这一层完成。
| 接口 | 用途 |
|---|---|
| /api/v1/chatlog | 按时间与聊天对象查询消息,支持 json / csv / 纯文本输出 |
| /api/v1/contact | 查询联系人信息 |
| /api/v1/chatroom | 查询群聊与成员 |
| /api/v1/session | 查询最近会话列表 |
图片、语音等多媒体消息也支持解密取回:语音会实时转码成 MP3,多媒体文件通过独立的资源路径按 ID 获取,方便和消息记录一起归档。
接入 AI 助手:MCP 接口
Chatlog 内置了 MCP SSE 标准接口(http://127.0.0.1:5030/sse),Cherry Studio、ChatWise 这类支持 SSE 直连的客户端把地址填进 MCP 配置就能用;Claude Desktop 等不支持 SSE 直连的客户端,可以借助 mcp-proxy 做一层转发。接好之后,AI 助手就能按你的提问检索聊天内容,做摘要、归纳话题、找特定对话,这也是它相比普通导出工具最大的差异点。
服务只监听本机 127.0.0.1,AI 客户端配置里同样填本机地址即可,不需要把端口暴露到局域网外。
使用前提与注意事项
- 电脑端记录不全时,先用微信自带的「聊天记录迁移与备份」把手机记录迁到电脑
- 获取密钥前建议先退出微信;Windows 下终端界面显示异常时换 Windows Terminal 打开
- macOS 获取密钥需要临时关闭 SIP,操作完成后记得恢复
- 支持多账号管理,可在账号间切换后分别解密查询
- 仅用于管理本人设备上的聊天记录备份,注意隐私合规,不用于读取他人数据
项目现状与资源说明
Chatlog 于 2025 年 3 月首次发布,一度积累九千多 Star。2025 年 10 月,作者因收到微信官方函件移除了仓库的全部代码与提交历史,官方渠道不再提供下载与更新。本页分享的是此前存档的纯净版打包,供已经在使用或愿意自行研究的用户参考。
| 项目 | 信息 |
|---|---|
| 分享文件 | Chatlog_纯净版.7z(文件名未标注版本号) |
| 参考版本线 | 仓库移除前最后公开版本 v0.0.31(2025-10,Go 模块索引记录) |
| 运行环境 | Windows / macOS(微信 3.x / 4.0),亦提供 Docker 镜像 |
| 开源协议 | Apache-2.0 |
| 项目地址 | github.com/sjzar/chatlog(作者已移除代码,仅存移除说明) |
由于官方仓库已移除,分享包与具体 release 的对应关系无法再逐项核对;本文功能描述以移除前公开的项目文档与 Go 模块索引记录为准。工具类存档请自行评估可用性,本页不标注「最新版」。



暂无评论内容