OpenClaw 操作 Obsidian 笔记:从文件直读到 API 调用的全攻略

我一直在用 Obsidian 做笔记库，同时也在用 OpenClaw 当 AI 助手。

这俩东西各管各的时候都很能打。但时间长了就发现一个问题——我经常在 OpenClaw 那边跟 AI 聊完一件事，回头又得去 Obsidian 里翻笔记、贴内容、补标签，反复横跳。

后来我干脆让 OpenClaw 直接读写我的 Obsidian 笔记库。试了两种方式，今天一次性讲清楚。

方案一：直接读写本地文件

一句话搞定

把你的 Obsidian 仓库路径告诉 AI，比如：

“我的 Obsidian 笔记在 F:\My_WenAn”

就这一句。之后你所有跟笔记相关的需求，AI 都能直接处理。

日常操作演示

打开笔记：

“帮我打开会计财务文件夹里的收支流水账”

新建笔记：

“在闲鱼运营目录下建一篇笔记，标题：新品上架计划，内容：……”

追加内容：

“在那篇门面续租协商笔记末尾加一段：下午三点对方又打来电话，说最多再加100”

搜索笔记：

“搜一下关于机器狗摩仔的文章有哪些”

批量操作：

“给会计财务目录下所有笔记加上 #财务 标签”

这个方案的槽点

• 不支持 Obsidian 内部链接 [[wikilink]]
• 不能按标签搜索
• 不能创建文件夹层级
• 遇到文件编码问题容易翻车（别问我怎么知道的）

日常记个流水账、查个笔记没问题，但要是深度管理，还是差点意思。

方案二：装上 REST API 插件（重点）

这才是今天要聊的重点。

为什么要装这个插件

Obsidian Local REST API 这个插件，本质上是给你的笔记库开了一个”后门”——它启动了一个本地 HTTP 服务器，让外部程序可以通过 API 调用来读取、写入、搜索你的笔记。

之前那套文件直读方案，像是隔着窗户看屋里。装了插件，等于直接拿了钥匙进门。

安装步骤（三步走）

第一步：装插件

打开 Obsidian，设置 → 第三方插件 → 社区插件市场 → 搜索「Local REST API with MCP」→ 安装并启用。

第二步：找到 API Key 和端口

装好后，在插件设置页面你会看到：

• 端口号：默认 27124（HTTPS）
• API Key：一串长字符串，复制保存好

这两样东西后面要用。

第三步：确保 Obsidian 在运行

这个插件跟 Obsidian 是共生的——Obsidian 开着，API 才工作。关了就断了，注意别关了窗口。

先测一下能不能通

在终端里跑一下这条命令（换成你自己的 API Key）：

curl -k -s -H "Authorization: Bearer 你的APIKey" https://localhost:27124/

如果返回类似这样的结果，说明通了：
{  "status": "OK",  "authenticated": true,  "service": "Obsidian Local REST API"}

这一步卡住的话，后面什么都干不了。

从入门到实战
下面我用真实际遇过的场景来演示，你照着来就行。
场景一：看看你的笔记库里有哪些标签

“看看我有哪些标签”

curl -k -s -H "Authorization: Bearer 你的APIKey" https://localhost:27124/tags/

返回结果就像这样：
{  "tags": [    { "name": "OpenClaw", "count": 2 },    { "name": "财务", "count": 1 },    { "name": "闲鱼", "count": 9 }  ]}

每个标签后面跟着篇数。你能一眼看出来——有的标签用得特别多（比如”闲鱼”），有的标签只出现一两次，可能是打偏了。这也是一种标签普查的方式。
场景二：用标签筛选笔记

“搜一下 #财务 标签下的笔记”

curl -k -s -H "Authorization: Bearer 你的APIKey" "https://localhost:27124/search/simple?query=tag:财务"

如果你用的是 v4 版本的插件，搜索接口需要 POST 请求。具体怎么传参，插件文档里有说明。
小技巧： 标签搜索是最常用的，因为大部分人的笔记一旦多了，光靠记标题根本找不到。
场景三：给笔记加上标签（在 YAML 里动手脚）
标签存在笔记文件开头的 YAML 区，就像这样：
---tags:  - 财务  - OpenClaw---

你可以直接通过 API 读取文件、修改 YAML、再写回去。不过更简单的办法是——让 AI 帮你干。
你对 AI 说一句：

“给那篇门面续租协商笔记加上 #租务 标签”

AI 会做三件事：


找到这篇笔记


读取它的 YAML 头


在 tags 列表里加一行 – 租务，然后写回去


整个过程在你反应过来之前就完了。
场景四：批量给一批笔记打标签
这是我觉得最值的一个场景。
想象一下：你有一个目录叫「会计财务」，里面散着五六篇笔记——记账凭证、收支流水、总公司账本……每篇内容都是财务相关的，但都没有标签。
以前你要手动一篇篇打开 Obsidian，加 YAML，打字，保存。五篇还好，五十篇呢？
现在你对 AI 说：

“帮我把会计财务目录下所有笔记加上 #财务 标签”

AI 会：


浏览会计财务目录


逐一检查每篇笔记是否已有标签


没有的自动添加，已有的跳过


给你一份处理报告


这背后其实就是遍历文件 + 正则替换 YAML 头，但换成手动干，烦也烦死了。
场景五：新建一篇带标签的笔记

“新建一篇笔记，标题：六月运营总结，内容：……，加上 #运营 #总结 标签”

AI 不光帮你写了内容，还在 YAML 里把标签安排好了。打开 Obsidian 一看，分类清晰，规规矩矩。

方案二还能做什么
装了这个插件之后，能做的事情远不止标签管理：
跨笔记搜索正文你可以搜索所有笔记正文里的内容——”找到所有提到’OpenClaw卡顿’的段落”。这在笔记多了以后是刚需。
通过 API 创建文件夹想给笔记库建个新分类目录？API 可以直接建文件夹，不用打开 Obsidian 手动点来点去。
写 Obsidian 内部链接[[wikilink]] 是 Obsidian 的特色。装了插件后，AI 写的笔记里可以自动带上内部链接，笔记之间互相引用，形成一个网。
与其他工具联动比如把 IMA 知识库里的内容自动同步到 Obsidian，或者定时把某个文件夹备份到别处。这些都可以自动化。


两套方案怎么选




场景


用哪个






临时记一笔、查个笔记


方案一，张嘴就说




管理几十上百篇笔记的标签


方案二，批量操作




只想读不想写


方案一，不用装东西




做自动化、联动其他工具


方案二，API 接口




全都要


都上，不冲突




两套方案可以共存。日常快速读写用方案一，深度管理用方案二。

最后说两句
写完这篇文章之后，我自己做的第一件事，是把 Vault 里 90 多篇笔记全部自动打上了标签。从”一篇一篇翻着手动弄”变成”一句话搞定”——这个转变本身，比这篇文章里任何技术细节都值得记住。
技术这东西，用对了是工具，用不对是负担。
你的 Obsidian 笔记库就是你个人的知识资产。让 AI 帮你管起来，不是偷懒，是把精力省下来，去做那些更有价值的事。