ChatLog：一键读取微信聊天记录的开源工具，支持API与AI助手集成

ChatLog介绍

ChatLog是一款开源聊天记录工具，专为处理和管理个人聊天数据设计。它允许用户从本地数据库文件中提取微信聊天记录，并通过多种方式查看、搜索和利用这些数据。无论是备份重要对话、查找历史信息，还是将聊天记录与AI助手集成，ChatLog都提供了简便易用的解决方案。

ChatLog亮点

• 多平台支持: 兼容Windows和macOS系统，适应不同用户的操作环境需求
• 微信版本兼容: 支持微信3.x和4.0版本，覆盖大多数用户群体
• 多重界面选择: 提供终端界面(TUI)和命令行工具，满足不同使用习惯
• HTTP API服务: 开放接口支持查询聊天记录、联系人、群聊及最近会话信息
• MCP SSE协议集成: 与支持MCP的AI助手无缝对接，扩展聊天记录应用场景

ChatLog使用教程

1. 下载并安装微信电脑客户端
2. 在手机微信中依次点击”我-设置-通用-聊天记录迁移与备份-迁移-迁移到电脑”，将手机聊天记录传输至电脑(此操作不会删除手机上的记录)
3. 下载ChatLog预编译版本或通过Go命令安装
4. 运行ChatLog程序，按界面提示解密数据并启动HTTP服务
5. 通过浏览器或AI助手访问已解密的聊天记录

macOS特别说明

macOS用户需要注意以下要点：

1. 获取密钥前需临时关闭SIP(系统完整性保护)并安装Xcode
   • 进入恢复模式：Intel Mac按住Command+R开机；Apple Silicon Mac长按电源键
   • 打开终端(实用工具-终端)
   • 输入命令csrutil disable关闭SIP
   • 重启系统
2. 安装Xcode(可从App Store下载)，因为密钥获取过程依赖lldb工具
3. 获取密钥后可重新启用SIP，不影响后续数据解密和服务运行

终端界面操作指南

启动程序后，可通过以下快捷键操作界面：

• 方向键：菜单导航
• Enter键：选择当前项
• Esc键：返回上级菜单
• Ctrl+C：退出程序

ChatLog API使用

启动HTTP服务后，可通过以下API访问数据：

聊天记录查询

GET /api/v1/chatlog?time=2023-01-01&talker=wxid_xxx&limit=100&offset=0&format=json

参数说明：

• time: 查询时间范围，格式为YYYY-MM-DD或YYYY-MM-DD~YYYY-MM-DD
• talker: 聊天对象ID(也支持使用备注名、昵称等)
• limit: 返回记录数量上限
• offset: 分页起始位置
• format: 输出格式(json/csv/文本)

MCP集成

ChatLog支持MCP SSE协议，提供四种工具函数：

• chatlog: 查询聊天记录
• query_contact: 查询联系人
• query_chat_room: 查询群聊
• query_recent_chat: 查询最近会话

集成示例：以ChatWise为例，在”设置-工具”中新建SSE类型工具，ID设为chatlog，URL设为http://127.0.0.1:5030/sse，启用自动执行即可。

对于不支持MCP SSE协议的AI工具，可使用mcp-proxy转发请求。

ChatLog获取方法

• 源码安装：go install github.com/sjzar/chatlog@latest
• 预编译版本：GitHub Releases页面
• GitHub仓库：sjzar/chatlog

开源许可

ChatLog基于Apache-2.0许可协议开源。

致谢

• 0xlane的wechat-dump-rs项目
• xaoyaoo的PyWxDump项目
• Anthropic的MCP协议
• Go开源库贡献者们