WeChat Local Data Reader: 访问聊天记录和联系人 - Openclaw Skills

什么是 WeChat Local Data Reader？

此技能为存储在 SQLite 数据库中的本地 WeChat 数据提供了一个只读接口。它使外部用户和 AI 代理能够以编程方式访问联系人列表、聊天会话、消息历史记录和收藏夹。基于隐私保护设计，它完全在本地运行，并且需要明确的权限才能访问系统目录，使其成为 Openclaw Skills 库中可靠的补充。该工具旨在在 macOS 上无缝运行，同时为 Windows 环境提供自定义路径支持。

下载入口:https://github.com/openclaw/skills/tree/main/skills/alphafactor/wechat

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install wechat

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 wechat。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

WeChat Local Data Reader 应用场景

• 获取联系人信息或聊天记录以供本地参考。
• 在存档消息中搜索特定的关键词或日期。
• 生成通信统计数据，包括消息量和会话计数。
• 访问收藏内容，用于个人知识管理或数据整理。

WeChat Local Data Reader 工作原理

1. 该技能识别本地 WeChat 数据目录，默认为 macOS 容器路径。
2. 它使用 mode=ro 标志与特定的 SQLite 数据库（如 Contact.sqlite 和 Chat.sqlite）建立只读连接。
3. 用户或 AI 代理执行命令来查询联系人、活动会话或特定的消息内容。
4. 该技能自动将原始 Unix 时间戳和元数据转换为人类可读的格式。
5. 结果在终端中本地渲染，或传递给调用代理进行进一步处理。

WeChat Local Data Reader 配置指南

首先，确保设备上已登录 WeChat。对于 macOS 用户，请通过“系统设置 -> 隐私与安全性 -> 完全磁盘访问权限”向您的终端应用程序授予“完全磁盘访问权限”。使用以下命令验证访问并初始化技能：

# Check directory access
ls -la ~/Library/Containers/com.tencent.xinWeChat/

# List available databases
python3 scripts/wechat.py list

# View contacts
python3 scripts/wechat.py contacts

WeChat Local Data Reader 数据架构与分类体系

该技能与多个核心 WeChat 数据库交互，按如下方式组织数据：

Database	Content	Metadata Saved
Contact.sqlite	用户联系人	WeChat ID, Nickname, Remarks
Session.sqlite	聊天会话	最近聊天, 未读计数
Chat.sqlite	消息日志	文本内容, 时间戳, 发送者信息
Favorite.sqlite	收藏项目	链接, 笔记, 收藏的消息
Brand.sqlite	公众号	关注的品牌和服务账号

name: wechat
description: Read WeChat local data from SQLite databases. Supports listing contacts, chat sessions, searching messages, and viewing favorites. Use when the user needs to access their own WeChat data stored locally. Requires access to WeChat data directory. Read-only operations only.

微信本地数据读取工具

安全读取微信本地 SQLite 数据库，获取联系人、聊天记录、收藏等信息。

?? 重要声明：本工具仅读取本地数据，不会修改任何文件。仅供用户查看自己的微信数据使用。

支持平台

• ? macOS (通过 ~/Library/Containers/com.tencent.xinWeChat/)
• ?? Windows (通过自定义路径)
• ? iOS/Android (无法直接访问本地数据库)

前提条件

1. 确保微信在电脑上登录过

本工具读取的是电脑版微信的本地数据库文件。

2. 权限检查

# 检查是否有权限访问微信数据目录
ls -la ~/Library/Containers/com.tencent.xinWeChat/

如果权限不足，可能需要：

# 授予终端完全磁盘访问权限
# 系统设置 → 隐私与安全 → 完全磁盘访问权限 → 添加终端

使用方法

列出找到的数据库

python3 scripts/wechat.py list

查看联系人列表

python3 scripts/wechat.py contacts

输出示例：

?? 联系人列表 (50 个):

序号   昵称/备注              微信号
--------------------------------------------------
1      张三                   zhangsan123
2      李四(同事)             lisi_work
3      家人群                 chatroom_xxx

查看最近会话

python3 scripts/wechat.py sessions --limit 20

输出示例：

?? 最近会话 (20 个):

??    家人群                  2024-01-15 20:30:15
      ?? [图片]

?? 5  张三                    2024-01-15 19:45:22
      ?? 明天见！

搜索消息内容

python3 scripts/wechat.py search "关键词" --limit 50

查看收藏内容

python3 scripts/wechat.py favorites --limit 20

查看统计数据

python3 scripts/wechat.py stats

输出示例：

?? 微信数据统计:

?? contact: /Users/xxx/Library/.../Contact.sqlite
?? session: /Users/xxx/Library/.../Session.sqlite
?? chat: /Users/xxx/Library/.../Chat.sqlite

----------------------------------------
?? 联系人数量: 1234
?? 会话数量: 156
?? 消息数量: 45678
? 收藏数量: 89

命令参考

自定义路径

如果微信安装在非默认位置：

python3 scripts/wechat.py --path /path/to/wechat/data contacts

Windows 路径示例：

python3 scripts/wechat.py --path "C:/Users/用户名/Documents/WeChat Files/" contacts

数据库说明

技术说明

• 使用 SQLite 只读模式 (mode=ro) 打开数据库
• 所有操作均为查询，不会执行 INSERT/UPDATE/DELETE
• 时间戳为毫秒级 Unix 时间戳，会自动转换为可读格式

常见问题

错误：Permission denied → 授予终端"完全磁盘访问权限"： 系统设置 → 隐私与安全 → 完全磁盘访问权限 → 添加终端

错误：未找到数据库文件 → 确认微信已登录过，或指定自定义路径 --path

错误：database is locked → 关闭微信后重试（微信运行时可能锁定数据库）

读取的内容是加密的？ → 部分字段可能经过加密，这是微信的安全机制

隐私与安全

• ? 本工具只读取本地数据，不上传任何信息
• ? 所有操作在本地完成
• ? 需要用户明确授权才能访问数据目录
• ?? 读取的数据包含个人隐私，请妥善保管

参考

• 微信数据存储格式基于 SQLite
• 参考文档: references/api.md