乐于分享
好东西不私藏

我把 AI 助手连进了 Obsidian,有些坑你可以避免

我把 AI 助手连进了 Obsidian,有些坑你可以避免

那天我看着自己 Obsidian 里的「公司信息」库发呆。五千多个文件,docx、xlsx、png 堆成山,整理得整整齐齐——但它是个"死库"。

我不用的时候,它就在硬盘里安静地躺着,谁也不理谁。

我想做的是:
让我的 AI 助手 WorkBuddy 能直接读写这个库。
它干活时产生的记忆、笔记、待办,自动流进 Obsidian;
反过来,我也能说一句"去我库里找找关于 XX 的材料",它直接调出来。
折腾了一晚上,这条路通了。
下面是我踩过的坑和最终跑通的方案,纯粹实战,没有虚构。

一、先说结论:比想象中简单

Obsidian 有个社区插件叫Local REST API(作者 coddingtonbear)。我用的版本 v4.1.4 已经原生内置了 MCP 服务器——也就是说,Obsidian 自己就能当一个 MCP 服务端,WorkBuddy 直接连上去就行,完全不需要额外装什么桥接程序
这一点省了大事。很多人以为要搞一堆 npx 脚本转发,其实不用。

二、踩坑实录

坑 1:HTTPS 的自签证书

插件默认开的是 HTTPS,端口 27124。我兴冲冲把地址填进 WorkBuddy 的配置,一连——报错:
self signed certificate
原因很简单:
插件自己生成了一张自签证书,而 WorkBuddy 底层的网络客户端(Node 的 fetch)默认不信任自签证书。
Key 对、端口对、格式对,就是卡在证书上。
解法:插件设置里把 HTTP 服务器打开(端口 27123,明文、无证书)。localhost 回环地址用明文完全没问题,还更稳。

坑 2:端口连不上(ECONNREFUSED)

切到 HTTP 27123 之后,又报错:
connect ECONNREFUSED 127.0.0.1:27123
这回不是配置问题,是Obsidian 根本没在监听
Local REST API 只在 vault 处于"打开"状态时才起服务。
我当时 Obsidian 没开,或者切到了别的库。
解法:把 Obsidian 打开、确认那个库是活动库、HTTP 服务器勾上,保持它运行着。WorkBuddy 连的时候 Obsidian 不能关。
坑 3:Key 复制错了(最隐蔽)
中途我换了仓库、在插件里重置了 Key,然后截图把 Key 发过去让助手填。结果两个端口都返回 401。
排查了半天才发现:
截图经过 OCR 识别,那串 64 位的十六进制 Key 被认错了几个字符。
旧 Key 也试了,同样 401——证明库确实切过去了,就是新 Key 不对。
解法:直接在插件设置页里全选复制Key 的明文,原样粘贴。别走截图。

三、最终跑通的配置

{ ”mcpServers”: { ”obsidian”: { ”type”: ”streamableHttp”, ”url”: ”http://127.0.0.1:27123/mcp/”, ”headers”: { ”Authorization”: ”Bearer 你的Key” }, ”timeout”: 30000 } }}

两个细节要注意:

  • type 必须是 streamableHttp
    ,不是 http。WorkBuddy 只认前者,写 http 会连不上(它内部实际尝试的是 streamableHttp 再退到 sse 两种传输)。
  • 每次重置 Key 后,去 WorkBuddy 的连接器管理页 → 自定义连接器 → obsidian → 信任/重连一下,配置变了要重建连接。
连上之后,WorkBuddy 能调用的工具足有 17 个:
读文件、写文件、追加、搜索、打标签、执行命令……整个库尽在掌握。

四、通了之后,我平时怎么用

最爽的是——我几乎什么都不用干,管道是常驻的。只要 Obsidian 开着、插件没关,它就一直在。
日常就三句话:
  1. "把今天聊的 XX 要点存到 Obsidian"
     —— 它直接在库里建好笔记,我打开就能看,不用手抄。
  1. "去我 Obsidian 里找关于 XX 的材料"
     —— 它搜我的库,把相关内容调出来当参考,不用我翻文件夹再贴给它。
  1. "每天收工自动留一份当日记忆"
     —— 设个定时任务,每天往 WorkBuddy/Memory/ 塞一份工作记录。哪天想回头看"上个月某天干了啥",去翻这个文件夹就行。
一个小提醒:Obsidian 一次只服务当前打开的那个库。你切到别的库,管道就连的是那个库。想连哪个就开哪个,不用改配置。

五、顺手给它画了张关系图谱

连上之后我手痒,想看看这个库到底长啥样。扫描结果把我吓一跳:998 个文件夹、5230 个文件。但问题来了——
这个库里几乎没有 .md 笔记。
全是原始资料:docx、xlsx、pptx、pdf、png。
也就是说,Obsidian 自带的那个「图谱」按钮(Ctrl/Cmd+G)对我没用——它只画 .md 笔记之间的 [[双链]] 关系,而我的库里没有互相链接的笔记。
所以我换了个思路:
按文件夹结构画。文件夹当节点,节点大小 = 里面文件数,连线 = 谁包含谁。
这样一张图就能看清整个资料库的结构。
更妙的是,我把它做成了一份Obsidian 原生 Canvas 文件(.canvas),直接推进库里。
在 Obsidian 里双击 Vault-Graph.canvas 就能打开——能拖、能缩放、能看连线,跟原生图谱体验一样,还不用联网。

六、关于"要不要先切片转成 md"

很多人一上来就问:是不是得先把所有文档切片转成 md,才能用知识图谱?
我的结论:不用,至少不用全量转。
如果只是想"看清库里有什么、结构长啥样"——文件夹图谱就够了,零转化。
真正划算的做法是:
给重点内容写"索引卡"——比如给「项目申报」「研发」各写一张 md,列关键文档 + 一句话说明,卡与卡之间用 [[项目申报]] 互相引用。
以后新增资料,顺手在某张卡里加一行。
图谱里冒出来的,就是有业务含义的关系,而不是一堆文件名。
而这活儿,AI 能替你干。
你不用自己打开 docx 去转,说一句"把『项目申报』里的关键文档做成索引笔记、互相链接",它就生成好几张带 [[链接]] 的 md 推回库里。

七、写在最后

工具本身是死的。
一个整理得再整齐的 Obsidian 库,不打开它、不连上它,就只是硬盘上的一堆字节。
让我真正感兴趣的,是连接——当 AI 助手能读我的库、写我的库、把它的记忆流进我的库,这个库才第一次"活"了起来。
它不是什么花哨的概念,它就是我的工作台,AI 是坐在旁边帮我翻档案、记笔记、画地图的搭档。
如果你也在用 Obsidian,不妨试试把你的 AI 助手连上来。坑就那几个,跨过去,世界不一样。
关注我获得AI新能力
预告:
一套 NotebookLM「拿来就能用」的作战手册
链接已经放在群公告中,请加群获取。
群码失效后可以私信我【加群】获得新的加群方式