2026-05-19 05:48:34 网络安全文章来源：ZONE.CI 全球网 0 阅读模式

文章总结： WeChatSync是一款开源Obsidian插件，通过微信官方iLink协议实现微信与笔记软件的双向同步。核心功能包括自动将微信消息（文字/图片/文件）保存为带元数据的笔记、在Obsidian内直接回复消息、支持群聊分类同步。技术亮点包括Node.js原生HTTP请求处理、CDN媒体文件AES解密、长轮询超时机制。安装需手动下载插件包或源码构建，需注意仅限桌面端使用且会话可能过期需重新登录。 综合评分： 87 文章分类： 安全工具,应用安全,数据安全,技术标准,解决方案

cover_image

微信消息自动存笔记？这个 Obsidian 插件让你和微信ClawBot 「双向奔赴」

爱唠叨的Nil

2026年5月18日 12:32 江苏

在小说阅读器读本章

去阅读

还在手动复制微信聊天记录到笔记？还在为微信和 Obsidian 之间的信息孤岛发愁？今天介绍一个开源插件，让你的微信和 Obsidian 真正打通。

🤔 你是不是也有这些烦恼？

作为 Obsidian 用户，你是不是经常遇到这些场景：

微信里收到一段重要信息，想存到 Obsidian，只能手动复制粘贴
朋友发来的图片、文件，想归档到笔记库，要下载再拖进去
微信里的灵感碎片散落各处，和 Obsidian 笔记体系完全脱节
想在 Obsidian 里直接回复微信消息？想都别想

微信和 Obsidian，明明是我们日常最常用的两个工具，却像两个平行世界。

今天，这个问题有解了。

🎯 WeChat Sync：让微信和 Obsidian 双向打通

WeChat Sync 是一个 Obsidian 插件，通过微信官方的 iLink 协议（就是微信 ClawBot 背后的那个协议），实现了微信和 Obsidian 之间的双向同步。

简单说，它能做到：

✅ 微信消息自动存入 Obsidian —— 收到的文字、图片、文件，自动创建笔记

✅ 从 Obsidian 直接回复微信 —— 在聊天框里打字就能回复，不用切回微信

✅ 图片/文件双向收发 —— 微信收到的图片自动下载，Obsidian 也能发图片到微信

✅ 群聊支持 —— 群消息也能同步，自动按群分类

✅ 双向增量同步 —— 修改笔记内容可以同步回微信，微信新消息也自动同步到笔记

✅ 自动更新 —— 基于 Gitee Release，有新版本自动提醒

🏗️ 它是怎么工作的？

整个架构基于微信官方的 iLink 协议，这是微信 ClawBot 功能背后的 HTTP/JSON 协议，合法合规，不用担心封号。

工作流程分三步：

第一步：扫码登录

和微信网页版一样，扫个二维码就行。插件会弹出二维码窗口，用手机微信扫一下确认，登录完成。

第二步：自动接收消息

登录后，插件通过长轮询机制持续监听微信消息。有人给你发消息，插件立刻收到，自动存入 Obsidian 笔记库。

第三步：直接回复

收到消息后，在 Obsidian 侧边栏的聊天框里直接打字回复，消息会通过 iLink 协议发送到微信。

微信用户 ──发消息──→ iLink 服务器 ──长轮询──→ Obsidian 插件
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ↓
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 自动创建笔记
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 存储图片/文件
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 保存 context_token
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │
微信用户 ←──回消息── iLink 服务器 ←──发送──── Obsidian 聊天框

🔑 核心设计：context_token 机制

iLink 协议最关键的概念是 context_token —— 每条入站消息都带有一个上下文令牌，回复时必须原样回传，服务端才能把消息路由到正确的微信会话。

插件会自动管理 context_token：

收到消息时自动提取并缓存
按用户 ID 存储，每个用户保留最新的 token
发送回复时自动带上对应的 token
支持跨 Obsidian 重启持久化

📦 安装方式

方式一：手动安装（推荐）

前往 Gitee Release 页面下载最新版本的 zip 包
解压到你的 Obsidian Vault 的 .obsidian/plugins/obsidian-wechat-sync/ 目录
在 Obsidian 设置中启用插件
点击侧边栏的微信图标，扫码登录

方式二：从源码构建

git&nbsp;clone&nbsp;https://gitee.com/hongjian_Ai/obsidian-wechat-sync.git
cd&nbsp;obsidian-wechat-sync
npm install
npm run build

🎮 使用指南

1️⃣ 扫码登录

点击侧边栏微信图标或使用命令 微信扫码登录，扫描弹出的二维码。

2️⃣ 开始监听

登录成功后自动开始监听，也可以点击「开始监听」按钮。

3️⃣ 收发消息

接收：微信消息自动存入 WeChat Inbox 文件夹，按日期命名
回复：在聊天框输入文字，按 Enter 发送
发送笔记：打开任意 Markdown 文件，使用命令 发送当前笔记到微信

4️⃣ 笔记格式

每条微信消息会自动创建带有 frontmatter 元数据的笔记：

---
wechat_msg_id:&nbsp;12345
wechat_from:&nbsp;"[email protected]"
wechat_time:&nbsp;"2026-05-18T10:30:00.000Z"
wechat_session:&nbsp;"session_xxx"
wechat_context_token:&nbsp;"AARzJW..."
wechat_is_group:&nbsp;false
---
对方发来的消息内容

有了这些元数据，你可以用 Obsidian 的 Dataview 插件做各种查询和统计！

🛡️ 安全说明

✅ 基于微信官方 iLink 协议，合法合规
✅ 所有数据本地处理，不上传任何信息到第三方服务器
✅ 认证凭据仅存储在本地 .obsidian/.wechat-sync-auth.json
✅ 仅限桌面端使用（需要 Node.js 环境）
⚠️ 会话可能过期，过期后需要重新扫码登录

🔧 技术亮点

作为一个开源项目，WeChat Sync 在技术上有几个值得关注的点：

全链路 Node.js HTTP 请求

Obsidian 的 requestUrl API 会自动将 HTTP 头名称转为小写（如 AuthorizationType → authorizationtype），而 iLink API 是大小写敏感的。插件使用 Node.js 原生 https 模块发起请求，完美保留 header 大小写。

长轮询超时处理

iLink 的 getupdates 接口会挂起 35 秒，插件设置了 60 秒超时，超时后自动重试，确保消息不丢失。

消息发送的「幽灵字段」

根据 OpenClaw 官方源码分析，sendmessage 接口除了文档中提到的 to_user_id、context_token、item_list 外，还必须包含 client_id、message_type: 2、message_state: 2 这三个「幽灵字段」。缺少任何一个，API 返回 200 但消息被静默丢弃。

CDN 媒体加解密

微信 CDN 上的媒体文件使用 AES-128-ECB 加密，插件内置了完整的加解密实现，支持图片、语音、文件、视频的下载和解密。

📋 功能路线图

| 阶段 | 功能 | 状态 | | — | — | — | | 第一阶段 | 扫码登录 + 消息接收 + 笔记创建 | ✅ 已完成 | | 第二阶段 | 回复消息 + 聊天视图 | ✅ 已完成 | | 第三阶段 | 图片/文件收发 + 群聊 + 冲突处理 | ✅ 已完成 | | 第四阶段 | 双向增量同步 + 自动同步 + frontmatter 追踪 | ✅ 已完成 | | 第五阶段 | 输入状态指示 + 媒体上传 + 多账号 | 🚧 规划中 |

🤝 参与贡献

项目完全开源，欢迎参与：

Gitee 仓库：https://gitee.com/hongjian_Ai/obsidian-wechat-sync
问题反馈：在 Gitee Issues 提交
功能建议：欢迎提 PR 或 Issue

💬 写在最后

微信是我们日常沟通的核心工具，Obsidian 是知识管理的利器。当这两个工具打通，信息就不再是孤岛 —— 微信里的灵感自动归档，Obsidian 里的知识随时分享。

如果你也是 Obsidian 用户，也受够了微信和笔记之间的割裂感，不妨试试 WeChat Sync。

扫码登录，消息自来。

项目地址：https://gitee.com/hongjian_Ai/obsidian-wechat-sync

如果觉得有用，欢迎 Star ⭐ 支持一下！

有使用上的建议和bug问题，群里反馈

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：爱唠叨的Nil 《微信消息自动存笔记？这个 Obsidian 插件让你和微信ClawBot 「双向奔赴」》