← 返回 Skills 市场
pjpan

微信聊天记录智能整理

作者 ppj · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
36
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install wechat-smart-organizer
功能描述
微信聊天记录智能整理技能。当用户想要读取微信聊天记录、提取关键信息、存储到Obsidian笔记、或创建日历事件时使用此技能。功能包括:查询会话、读取聊天记录、搜索关键词、提取任务/时间/待办事项、智能分类存储到Obsidian、创建日历提醒。
使用说明 (SKILL.md)

微信聊天记录智能整理技能

本技能整合 wechat-cli、Obsidian 笔记系统和日历系统,帮助用户从微信聊天记录中提取关键信息并智能整理。

核心能力

  1. 读取微信数据 - 通过 wechat-cli 访问本地微信聊天记录
  2. 智能信息提取 - 从聊天内容中识别任务、截止日期、会议、联系人等关键信息
  3. Obsidian 存储 - 将整理后的信息存储到 Obsidian 知识库
  4. 日历事件创建 - 识别时间相关事项并创建日历事件和提醒

微信聊天记录智能整理技能

本技能整合 wechat-cli、Obsidian 笔记系统和日历系统,帮助用户从微信聊天记录中提取关键信息并智能整理。

核心能力

  1. 读取微信数据 - 通过 wechat-cli 访问本地微信聊天记录
  2. 智能信息提取 - 从聊天内容中识别任务、截止日期、会议、联系人等关键信息
  3. Obsidian 存储 - 将整理后的信息存储到 Obsidian 知识库
  4. 日历事件创建 - 识别时间相关事项并创建日历事件和提醒

前置检查

检查 wechat-cli 安装状态

which wechat-cli

如果未安装,提示用户执行:

npm install -g @canghe_ai/wechat-cli
# 或
pip install wechat-cli

初始化微信数据访问

首次使用需要初始化:

sudo wechat-cli init

⚠️ macOS 用户需要授予终端「完全磁盘访问权限」

核心命令参考

会话管理

wechat-cli sessions                    # 最近会话列表
wechat-cli sessions --limit 10        # 指定数量
wechat-cli unread                     # 未读会话

聊天记录读取

wechat-cli history "联系人/群名" --limit 50           # 最近50条
wechat-cli history "联系人" --start-time "2026-01-01" --end-time "2026-01-31"  # 时间范围
wechat-cli history "群名" --type link                  # 仅链接类消息

搜索功能

wechat-cli search "关键词"                              # 全局搜索
wechat-cli search "deadline" --chat "项目群"          # 指定聊天搜索
wechat-cli search "会议" --type text                   # 仅文本消息

联系人与统计

wechat-cli contacts --query "姓名"     # 搜索联系人
wechat-cli stats "群名"               # 群聊统计
wechat-cli members "群名"            # 群成员列表

导出功能

wechat-cli export "联系人" --format markdown --output chat.md
wechat-cli favorites                   # 微信收藏

Obsidian Vault 检测

获取 Obsidian Vault 列表

在 macOS 上,Obsidian vault 配置存储在:

~/Library/Application Support/obsidian/obsidian.json

检测步骤:

  1. 读取 Obsidian 配置文件:
cat ~/Library/Application\ Support/obsidian/obsidian.json
  1. 解析 vault 信息:
{
  "vaults": {
    "vault_id_1": {
      "path": "/Users/xxx/Documents/obsidian/vault1",
      "ts": 1234567890,
      "open": true
    },
    "vault_id_2": {
      "path": "/Users/xxx/另一个笔记库",
      "ts": 1234567890,
      "open": false
    }
  }
}
  1. 优先规则
    • 如果只有一个 vault,直接使用
    • 如果有多个 vault,询问用户选择
    • 优先使用 open: true 的 vault

Obsidian 存储路径

重要:Obsidian vault 路径不是 ~/Obsidian/,而是实际配置的路径。

常见路径格式:

  • /Users/{用户名}/Documents/obsidian/{vault名}/
  • /Users/{用户名}/{自定义路径}/

智能信息提取流程

步骤1:获取原始数据

根据用户需求选择合适的命令获取聊天记录:

  • 日常浏览wechat-cli sessions --limit 20
  • 特定联系人wechat-cli history "姓名" --limit 100 --format json
  • 关键词搜索wechat-cli search "关键词" --limit 50 --format json

步骤2:识别关键信息

从聊天内容中智能识别以下类型的信息:

类型 识别关键词 示例
任务/待办 "需要做"、"麻烦"、"帮我"、"记得" "记得明天帮我带文件"
截止日期 "截止"、"deadline"、"周X"、"X号" "这个任务截止到周五"
会议/约定 "会议"、"约"、"几点"、"什么时候" "我们约明天下午3点开会"
电话/联系方式 "电话"、"微信"、"加我" "加我微信: xxx"
地址/位置 "地址"、"去哪"、"位置" "公司地址是xxx"
金额/交易 "多少钱"、"转账"、"收款" "这个产品298元"
重要文件 "文件"、"发给你"、"附件" "我把合同发给你"

步骤3:分类存储

根据信息类型选择存储目标:

存储到 Obsidian

重要:先检测 Obsidian vault 的实际路径,不要假设为 ~/Obsidian/

步骤

  1. 检测 Obsidian vault 路径
# 读取 Obsidian 配置文件
cat ~/Library/"Application Support"/obsidian/obsidian.json

# 解析 JSON,获取 vault 路径
# 格式:{"vaults":{"vault_id_1":{"path":"/actual/path","ts":...,"open":true}}}
  1. 确定目标路径

    • 如果只有一个 vault,直接使用
    • 如果有多个 vault,询问用户选择
    • 优先使用 open: true 的 vault
  2. 按类型创建/更新笔记(使用检测到的 vault 路径):

    • 任务{vault_path}/待办事项/{日期}.md
    • 会议{vault_path}/会议记录/{日期}-{主题}.md
    • 联系人{vault_path}/联系人/{姓名}.md
    • 项目{vault_path}/项目/{项目名}/相关沟通.md
    • 幼儿教育{vault_path}/幼儿教育/{主题分类}/

注意

  • Vault 路径可能包含空格(如 /Users/xxx/Documents/obsidian/ppj/),复制文件时需要用引号包裹路径
  • 如果无法读取 Obsidian 配置,再回退到询问用户

Obsidian 笔记模板格式

---
type: wechat-extract
source: {联系人/群名}
created: {当前日期}
tags: [#微信 #待办] 或 [#微信 #会议]
---

# {标题}

## 原始内容
> {引用原文}

## 提取信息
{关键字段}

## 提取时间
{当前时间}

## 相关上下文
{周围聊天内容}

存储到日历

对于包含明确时间的事项,创建日历事件:

  1. 识别时间表达式("明天3点"、"周五下午"、"下周一")
  2. 构建日历事件:
    • 事件标题:从聊天内容提取
    • 开始/结束时间:基于识别的时间
    • 提醒:提前15-30分钟
    • 备注:完整聊天上下文

使用腾讯会议技能创建会议(如涉及多方):

# 调用 tencent-meeting-skill 创建会议

使用场景示例

场景1:整理项目沟通

用户:帮我把「项目A群」里关于「周五上线」的消息整理一下

执行流程:

  1. wechat-cli search "上线" --chat "项目A群" --format json
  2. 提取所有相关消息
  3. 创建 Obsidian 笔记:项目/项目A/周五上线沟通.md
  4. 如有明确时间,创建日历提醒

场景2:提取待办事项

用户:从和老板的聊天记录里找出所有待办

执行流程:

  1. wechat-cli history "老板" --limit 200 --format json
  2. 筛选包含待办关键词的消息
  3. 生成待办清单
  4. 存储到 ~/Obsidian/待办/老板安排.md

场景3:备份重要联系人信息

用户:把最近加的联系人信息存到笔记里

执行流程:

  1. wechat-cli contacts --query "关键词"
  2. 获取联系人详情
  3. 创建 Obsidian 联系人笔记

输出格式规范

终端输出

使用 --format text 参数获取人类可读的输出格式。

JSON 输出

使用 --format json 参数获取结构化数据,便于程序处理。

文件导出

使用 --output {文件名} 将内容导出到文件。

注意事项

  1. 隐私保护:微信数据仅本地处理,不上传任何数据
  2. 微信运行要求:执行命令时微信需处于运行状态
  3. 权限要求:macOS 需授予「完全磁盘访问权限」
  4. 首次使用:先运行 sudo wechat-cli init 初始化
  5. Obsidian 路径检测必须先检测 Obsidian vault 的实际路径,不要假设为 ~/Obsidian/
    • 读取 ~/Library/Application Support/obsidian/obsidian.json
    • 解析 vaults 字段获取实际路径
    • 示例:/Users/peterpan/Documents/obsidian/ppj/(不是 ~/Obsidian/
  6. 时间识别:时间表达式的解析需结合上下文确认准确性
  7. 文件权限:微信本地文件默认只读(-r--r--r--),复制后可能需要修改权限

错误处理

错误信息 解决方案
"微信未运行" 启动微信后重试
"需要初始化" 运行 sudo wechat-cli init
"权限被拒绝" 检查终端是否具有完全磁盘访问权限
"找不到联系人" 使用 wechat-cli sessions 确认正确的联系人名称
安全使用建议
Review this skill carefully before installing. It appears designed for the stated WeChat-to-Obsidian workflow, but you should verify the wechat-cli package source, avoid granting broad permissions unless necessary, inspect extracted notes before saving, and be cautious with attachment handling because the included script scans the whole WeChat files directory.
功能分析
Type: OpenClaw Skill Name: wechat-smart-organizer Version: 1.0.0 The skill requires high-privilege access to sensitive local data, including the WeChat message database (via sudo wechat-cli) and Obsidian configuration files (~/Library/Application Support/obsidian/obsidian.json). While these actions are aligned with the stated purpose of organizing chat logs into notes, the broad file system access and the requirement for 'Full Disk Access' on macOS constitute high-risk behaviors. The scripts (extract_key_info.py and save_to_obsidian.py) do not currently contain exfiltration logic, but the capability to read private communications and application metadata warrants a cautious classification.
能力评估
Purpose & Capability
The stated purpose—reading WeChat chats, extracting tasks/dates/contacts, and saving to Obsidian—is coherent with the documented commands and scripts, but it necessarily handles very sensitive private chat data.
Instruction Scope
The instructions include broad operations such as global WeChat search, favorites/export access, and attachment handling without clear per-chat scoping or confirmation boundaries.
Install Mechanism
The skill is listed as instruction-only with no required binaries, but SKILL.md tells users to install an unpinned external wechat-cli package and run initialization with sudo.
Credentials
The skill requests macOS Full Disk Access and reads local WeChat and Obsidian application data, which is broader than ordinary note-taking automation and should be explicitly scoped.
Persistence & Privilege
Saving extracted chat content into Obsidian is purpose-aligned and disclosed, but it makes private chat content persistent in the user’s knowledge base.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install wechat-smart-organizer
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /wechat-smart-organizer 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
初始版本:支持微信聊天记录整理、Obsidian 存储、日历事件创建
元数据
Slug wechat-smart-organizer
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

微信聊天记录智能整理 是什么?

微信聊天记录智能整理技能。当用户想要读取微信聊天记录、提取关键信息、存储到Obsidian笔记、或创建日历事件时使用此技能。功能包括:查询会话、读取聊天记录、搜索关键词、提取任务/时间/待办事项、智能分类存储到Obsidian、创建日历提醒。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 36 次。

如何安装 微信聊天记录智能整理?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install wechat-smart-organizer」即可一键安装,无需额外配置。

微信聊天记录智能整理 是免费的吗?

是的,微信聊天记录智能整理 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

微信聊天记录智能整理 支持哪些平台?

微信聊天记录智能整理 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 微信聊天记录智能整理?

由 ppj(@pjpan)开发并维护,当前版本 v1.0.0。

💬 留言讨论