前几天我介绍了怎么使用 Obsidian 配合 Claudian 和 Claude Code 来搭建个人 AI 助理:用 Obsidian+Claudian+Ds 搭建个人 AI 助理

相信你用了以后,会不断解锁新的应用场景,也会让 AI 帮你做越来越多的事情,随着我们交给它的工作也越来越繁重,于是我相信你一定会遇到如下类似的问题:

魂牵梦萦


Agent 能干的事越来越多,但完成任务的耗时也跟着越来越长——从几分钟,到半小时,到一个多小时。你给它派了个活,它陷入了一个又一个的思考,半天结束不了,于是你决定不等了,去干点其他的事,但是人虽然去干别的了,心却留在那儿:过一会儿忍不住切回去看一眼,再过一会儿又看一眼,走到哪了?报错没有?搞得魂牵梦萦,手头的事也没干踏实。

2026-08-17_1109_article0.png

图1:AI Thinking…

更糟的情况是:你终于走开一阵,回来一看——Agent 在二十分钟前就停下了:它遇到了一个分叉点,提了一个问题,然后一直、一直地等着你回复,白白浪费了几十分钟。

2026-08-17_1109_article1.png

图2:Agent 卡在分叉点提了个问题

于是你想,能不能让他在完成任务,或者需要你的时候,能主动联系到你呢?

公众号内容归档


你在微信里看到一篇好文章,想存进自己的知识库。找一圈工具,发现主流做法是把文章转发给某个小程序、某个云端服务,由对方的服务器解析完再吐给你。就类似我上一篇文章介绍的 WeChat Obsync 插件。

先不说用小程序的方式操作起来会比较麻烦,最重要的还是因为小程序需要依赖一个第三方中转。你可能会担忧,你想收藏的每一条内容,都必须先经过别人的"手"。对方看没看不该看的、存没存、留多久——你没有任何控制力,总觉得会被窥探。

于是你想,能不能有一个不用经过第三方的方式来同步微信内容呢?

Wechatian


困扰你的,也是困扰我的。我尝试过用 iMessage、邮件,甚至在自己的个人服务器上做过 Push 服务,但都比较麻烦,用起来也不那么自然。毕竟对于我们国人来说,花时间最多的 APP 永远是微信。于是我让 AI 帮我写了一个 Obsidian 插件:Wechatian,让 Agent 永远可以第一时间找到我们。

Wechatian 是一个 Obsidian 插件,是我受到 CC Connect 启发、让我的 AI 花了 4 个小时做的(不直接用 CC Connect 是因为它过于庞大,也不能接入 Obsidian 生态)。它的主要功能用一句话来总结就是:**把微信变成你的 AI Agent 和你的知识库之间的双向通道**。

- 收:从微信发文字、图片、文章链接,自动落入你的知识库
- 发:AI Agent 想找你时,往一个文件夹里丢个消息,你的微信就响了

架构:只有两端,没有中间商


微信 <—> 腾讯 ilink AI 网关 <—> Wechatian <—> 你的知识库


链路上只有两端:微信官方网关,和你本地的 Obsidian。几个关键设计决策:

**1. 走腾讯 ilink AI 机器人网关**

没有非官方协议 hack,不需要自建中继服务器。插件通过长轮询直接与微信官方网关通信。

**2. 消息内容只存在于你自己的知识库**

收到的文字、图片、文章正文,全部以 markdown 和文件形式写进你的知识库,不经过任何第三方服务。这正是它和"小程序中转"式剪藏工具的本质区别——你的知识库入口,不再经过别人的手。

**3. 发送走文件发件箱**

插件不暴露任何 API。想发微信消息,就往 <Wechatian>/outbox/ 写一个文件:

- 写一个 .md,内容作为文本消息发出(支持 markdown 格式——标题、列表、加粗、代码块都行)
- 丢一张图片、一段视频、一份文档(≤100MB),作为附件发出

插件每 30 秒轮询一次发件箱,取出文件、加密、通过微信送达。

这个设计带来一个额外的好处:**任何会写文件的程序都能发微信**——shell 脚本、Python、任何 AI Agent。不需要 SDK,不需要集成,零接入成本。

**4. Agent 协议自描述**

插件在收件目录自动维护一份 Agent.md,写清楚当前的目录结构和收发协议。你不需要教你的 AI 助手任何东西,把这份文件指给它,它自己就学会了怎么给你发微信、怎么读你的回复。

**5. 扫码绑定,只认你自己**

扫码登录后,插件只接受绑定账号发来的消息。即使机器人 ID 泄露,别人也无法往你的 vault 写任何东西。

功能清单


**接收侧**

- 长轮询实时收消息,写入每日对话笔记——每天一份 <日期>.md,收和发都记在里面,按时间排列,本身就是一份可读的双向对话记录
- 图片、文件、视频、语音自动下载并解密到 attachments/
- 消息里的文章链接自动剪藏:正文转 markdown、文内图片全部下载到本地,存成文章笔记,对话笔记里只留标题链接

**发送侧**

- 文本消息、文件、图片、视频、公众号文章
- 每条发送都记录在案,失败可查原因

实际用起来是什么样


这几天我自己用得最多的三个场景:

**文章剪藏。**微信里看到好文章,复制链接,直接把链接发给 bot。几秒后就在知识库里多了一份全文 markdown 笔记,配图全部本地化。注意别用转发——网关收不到转发的文章和文件,发原始链接就行。

**远程指挥 Agent。**出门前告诉 Agent 监听微信消息,于是你人在外面,突然有了新想法,就在微信里给 Bot 发一句"检查一下 yar_compact,是不是真的需要 detach,完成后微信通知我结果",家里的 Agent 收到就开始干活。改完的结果再发回微信。微信成了 Agent 的遥控器。

**长任务通知。**Agent 跑一个耗时任务,你要去忙其他事,于是告诉她"如果有问题,或者结束了,微信通知我"。于是她就在结束时往发件箱写一句"构建完成,0 错误",几秒内你的微信就响了。再也不用守着屏幕,也不会错过它卡在问题里等你回复——卡住了,它会来问你。

2026-08-17_1109_article2.png

图3:长任务结束,Jarvis 直接把结果发到微信

安装和使用


最省事的用法:直接把下面这句话丢给你的 AI 助手,它会替你装好:

前往 https://github.com/laruence/wechatian,按其中的说明把 Wechatian 插件安装到我的 Obsidian。


它会自己下载插件、放进插件目录、带你走完全程。

如果你想自己手动安装,那么:在 Obsidian 设置 → 第三方插件 → 社区插件市场搜索"wechatian",点击安装即可。当然也可以自己下载安装,首先在 GitHub 搜索 Wechatian

2026-08-17_1109_article3.png

图4:在 GitHub 搜索wechatian

然后:

1. 在 GitHub 的 Wechatian 仓库页面下载最新版 Release,其中包含 main.js、manifest.json、styles.css 三个主要文件
2. 三个文件放进 <你的 vault>/.obsidian/plugins/wechatian/
3. Obsidian 设置 → 第三方插件 → 启用 Wechatian
4. 打开 Wechatian 设置页,登录绑定的二维码会自动出现:

图5:Wechatian 设置页弹出的登录二维码
5. 用微信扫码并确认,联系人里就会出现一个"微信 ClawBot"。当然,你还可以给它改名、改头像,我就把它改成了 Jarvis 😂 扫码确认后,插件会提示已登录、开始接收消息:
 
图6:手机扫码确认(左),桌面端提示已登录、开始接收消息(右)
6. 从微信给 bot 发一条任意消息——网关规定:绑定账号先给 bot 发过消息,才会下发发送凭据。没发之前点 Test Send 会失败,提示还没有发送凭据。你从微信给 bot 发一句"你好",桌面端收到的同时,发送方向也就解锁了:
 
图7:发送凭据尚未下发(左),收到"你好"后发送方向解锁(右)

回到设置页点 Test Send,桌面端提示发送成功,手机端收到 bot 的回复——双向通道就打通了:

已绑定Test Send就绪 消息发送成功

手机端收到bot回复

图8:已绑定、Test Send 就绪(上),发送成功(中),手机端收到 bot 回复(下)

如果你的微信收到了消息,那就是大功告成!

> 进一步,你还可以让你的 AI Agent 去 Wechatian 目录下阅读 Agent.md,之后你就可以跟你的 Agent 说:"结束了微信通知我"、"把 xxx 文件发送微信给我"。

几点说明:

- 仅支持桌面端 Obsidian 1.13.0+(长轮询机制,移动端暂不支持)
- 微信的 Bot 不支持像联系人一样随手转发给它,所以文章需要复制链接后发送,图片和文件需要存在本地,或者收藏后走文件发送渠道
- 同一个微信账号同时只建议一台设备在线,多端轮询会争抢消息
- 网关对主动发送有限流。这条通道适合通知和拍板,不适合当聊天软件刷
- 电脑离线也不怕——离线期间发给 bot 的消息,网关会暂存,下次打开 Obsidian 自动补抓(网关保留多久没有明确说明,太久的消息不保证)

当然,如果你不是一个 Obsidian+Claudian 的用户,你也可以让你的 Agent 参考 Wechatian,实现一套能在你的 Agent 里运行的"Wechatian"。Enjoy!

GitHub 仓库地址:https://github.com/laruence/wechatian

---

Note:本文由 Jarvis(作者的 AI 助理)从公众号「风雪之隅」自动同步至本博客。

微信公众号阅读公众号原文:《Wechatian: 让AI有事就来微信找你》