乐于分享
好东西不私藏

OpenClaw 接入 Obsidian 的实现过程

OpenClaw 接入 Obsidian 的实现过程

最近在尝试用 OpenClaw(小龙虾)做一些自动化的事情,目前主要是在 Mac 和 Linux 上进行部署,并通过飞书来指挥它执行任务。

但在实际使用过程中,我发现一个问题:

👉 小龙虾“部署完成”,并不等于“具备工作能力”。

于是我给自己设了一个更具体的目标:

👉 让它帮我整理 Obsidian 的个人笔记。


为什么是 Obsidian

Obsidian 是一款基于 Markdown 的本地笔记软件,拥有非常丰富的插件生态。

在使用过印象笔记、Notion、OneNote 等工具之后,我最终选择了 Obsidian,原因主要有:

  • 数据完全本地化(Markdown 文件)

  • 插件生态强

  • 灵活性高

当然,它也有一个比较明显的缺点:

官方同步服务价格较高(约 $10/月)

所以我目前的方案是:

👉 使用 Git(gitee)来做多端同步

虽然这种方式无法很好支持 iPhone 和 iPad 的同步,但在当前阶段对我来说是可以接受的。


尝试接入 OpenClaw

在接入小龙虾之前,我先尝试了 Obsidian 提供的命令行工具:

👉 Obsidian CLI(新版功能)

需要注意的是:

  • 需要更新到较新的版本(我测试的是 1.11.7)
  • 当前 Obsidian CLI 依赖桌面应用运行环境

这就带来一个问题:

❌ 无法在无头(headless)的 Linux 环境中使用


Headless 方案的尝试

我也尝试了 Obsidian 的无头客户端(Headless)

它的特点是:

  • 不依赖桌面界面
  • 可以通过命令行操作

但实际看下来,它的能力主要集中在:

👉 云同步相关操作

而不是:

👉 本地 Markdown 文件的读写

这并不符合我的需求。


转向 OpenClaw + Skills

于是我开始尝试另一条路径:

👉 使用 OpenClaw + skills 来操作 Obsidian

我在 clawhub 上找到了一个相关的 skill:https://clawhub.ai/steipete/obsidian

一开始我有一个怀疑:👉 在没有 GUI 的环境下,这个 skill 很可能并没有真正执行,而只是大语言模型“模拟完成了任务”。

但在实际验证之后,我发现:✅ 即使不依赖该 skill,小龙虾依然可以直接对本地 Obsidian 仓库中的 Markdown 文件进行读写操作,并且修改是真实生效的

也就是说:👉 对于“笔记整理”这类场景,本质上并不依赖 Obsidian 本身,而是对 Markdown 文件的操作能力。

这让我意识到一个更本质的点:👉 OpenClaw 的核心能力,并不是“调用某个软件”,而是“操作文件系统 + 理解文本内容”。


当前的实际方案

在完成上述尝试后,我最终采用了一个更简单直接的方式:

  • 使用 Git 拉取 Obsidian 仓库
  • 在 Linux 环境中进行操作

例如:

/home/user/obsidian_openclaw_test

然后直接告诉小龙虾:

1/home/user/obsidian_openclaw_test 2这个目录是一个受git 管理的Obsidian 仓库,可以直接操作里面的内容,修改后提交并 push 到 Git

之后在pc端使用git pull

👉 本质上,这是一个“AI 操作本地文件 + Git 同步”的方案。


一点结论

AI 时代让工具越来越简单、门槛越来越低,与其反复担心工具会不会取代自己,不如先让工具为自己工作一次。很多认知,不是在思考中建立的,而是在实践中被迫形成的。