在现代社交软件的世界里，微信无疑占据着重要地位。随着使用微信的用户越来越多，微信聊天记录的存储和管理变得至关重要。尤其是对于一些需要分析和提取大量聊天数据的用户来说，如何高效地获取并处理微信聊天记录成了一个值得关注的问题。今天，我们要介绍的就是一个能够从微信本地数据库文件中提取微信聊天数据的工具——chatlog。
chatlog工具概述
本工具是一款强大的微信聊天数据提取与管理工具，支持在Windows和macOS系统上运行，兼容微信3.x至4.0版本。它能够从本地微信数据库文件中高效提取聊天记录，支持包括个人聊天、群聊、最近会话等多种数据类型的查询。同时，工具内置Terminal UI界面与命令行操作方式，适合不同用户的使用习惯，极大提升了操作的灵活性与便捷性。
为了满足更高阶的集成需求，本工具还内置了HTTP API服务，开发者可通过API接口实现对聊天数据的远程调用与管理，例如快速查询聊天历史、获取股市相关讨论、筛选特定群聊内容等，适用于数据分析、聊天记录归档等场景。此外，工具全面支持MCP SSE协议，可与支持MCP协议的AI助手无缝集成，实现智能聊天数据分析与自动化响应等高级功能。
在多媒体数据处理方面，本工具同样表现出色，支持图片、语音等多种消息类型的解密与查看，确保用户能够完整还原原始聊天内容。同时，它具备自动识别与解密微信数据的能力，极大简化了使用流程，无需手动导出或转换数据，提升使用效率。
值得一提的是，工具支持微信多账号管理，用户可在多个账号之间自由切换，方便进行跨账号数据查看与管理，适用于企业用户或多微信号用户的日常使用需求。综合来看，该工具是一个集数据提取、查询、展示与API服务于一体的全功能解决方案，适合技术用户、开发者及数据分析人员使用。
Chatlog 是一个用于解析和查看微信聊天记录的工具，支持终端 UI、命令行操作、HTTP API 访问，并可与 AI 助手集成。本文将详细介绍 Chatlog 的安装、使用、常见问题解决方案及 API 接口。
chatlog使用流程
- 安装聊天记录：你可以 下载预译版本 或 使用 Go 安装。
- 运行程序：打开终端并执行以下命令启动 UI 界面：
chatlog
- 解密数据：在 UI 中选择
解密数据菜单项。 - 开启 HTTP 服务：选择
开启 HTTP 服务菜单项。 - 访问数据：通过 HTTP API 或 MCP 集成 查看聊天记录。
💡 提示：如果电脑端微信聊天记录不完整，可以 从手机端迁移数据。
常见问题快速解决
安装指南
使用 Go 安装
go install github.com/sjzar/chatlog@latest
下载预编译版本
在本页面底部下载适用于你系统的版本。
使用指南
终端 UI 模式
最简单的方式是直接运行：
chatlog
操作方法：
- 使用
↑↓方向键选择菜单项 - 按
Enter确认选择 - 按
Esc返回上级菜单 - 按
Ctrl+C退出程序
命令行模式
# 获取微信数据密钥 chatlog key # 解密数据库文件 chatlog decrypt # 启动 HTTP 服务 chatlog server
从手机迁移聊天记录
- 打开手机微信，进入
我 - 设置 - 通用 - 聊天记录迁移与备份 - 选择
迁移 - 迁移到电脑，按照提示操作 - 完成后，重新运行
chatlog获取密钥并解密数据
此操作不会影响手机上的聊天记录，只是将数据复制到电脑端
平台特定说明
Windows 版本说明
如遇界面显示异常（如花屏、乱码），请使用 Windows Terminal。
macOS 版本说明
- 关闭 SIP：
# Intel Mac：重启时按住 Command + R # Apple Silicon：重启时长按电源键 # 在恢复模式中打开终端并执行： csrutil disable # 重启系统
- 安装必要工具（安装Xcode Command Line Tools）：
xcode-select --install
- 获取密钥后： 可重新启用 SIP：
csrutil enable
用户注意：确保微信、聊天日志和终端都不在 Rosetta 模式下运行
HTTP API
启动 HTTP 服务后（默认地址：http://127.0.0.1:5030），可通过以下接口访问数据。
聊天记录查询
GET /api/v1/chatlog?time=2023-01-01&talker=wxid_xxx
参数说明：
time: 时间范围，格式为YYYY-MM-DD或YYYY-MM-DD~YYYY-MM-DDtalker: 聊天对象标识（支持 wxid、群聊 ID、备注名、昵称等）limit: 返回记录数量offset: 分页偏移量format: 输出格式，支持json、csv或纯文本
其他 API 接口
- 联系人列表：
GET /api/v1/contact - 群聊列表：
GET /api/v1/chatroom - 会话列表：
GET /api/v1/session
多媒体内容访问
- 图片内容：
GET /image/<id> - 视频内容：
GET /video/<id> - 文件内容：
GET /file/<id> - 语音内容：
GET /voice/<id> - 其他多媒体：
GET /data/<data dir relative path>
语音内容将自动转码为 MP3 返回，加密图片将实时解密处理。
MCP 集成
Chatlog 支持 MCP（Model Context Protocol）SSE 协议，可与支持 MCP 的 AI 助手无缝集成。
SSE 接口
GET /sse
快速集成方式
- ChatWise： 工具设置中添加
http://127.0.0.1:5030/sse - Cherry Studio： MCP 服务器设置中添加
http://127.0.0.1:5030/sse
通过 mcp-proxy 支持的客户端
- Claude Desktop： 需要配置
claude_desktop_config.json - Monica Code： 需在 VSCode 插件设置中配置
详细配置请参考 MCP 集成指南