前言¶

Obsidian 的库（vault）本质上就是一个磁盘上的普通文件夹：笔记是纯 Markdown 文本，配置在 .obsidian/ 目录里，附件是你自己在设置里选的目录。日常编辑用 Obsidian 没问题，但当你想批量改文件名、跨笔记改链接、或者让脚本自动做点事时，直接操作文件系统往往更直接。

下面介绍的这个 Skill 就是基于这个思路：不依赖 Obsidian 插件 API，而是把库当普通文件夹管理，同时通过 obsidian-cli 实现创建、改名、搜索这类自动化操作。

这是什么¶

obsidian-1-0-0（坐标 @clawhub_terryren2024/obsidian-1-0-0）是发布者 terryren2024 在 ClawHub 上维护的 Agent Skill，版本 1.0.0，分类 knowledge-management，许可证 MIT-0。它解决的问题是：让自动化脚本和 Agent 能直接读写 Obsidian 库中的 Markdown 笔记，并借助 obsidian-cli 完成需要 Obsidian URI 支持的操作。

该 Skill 在 SkillHub 上的页面显示评分 100000、下载 7373 次、安装 123 次（数据来源见文末官方地址）。注意：不同统计口径下评分与下载量数字会有差异，本文以 SkillHub 页面为准。

核心功能¶

1、把 Obsidian 库当普通磁盘文件夹对待：笔记是 *.md 纯文本，画布是 *.canvas（JSON），配置在 .obsidian/，附件目录由用户自己在 Obsidian 设置里选择。

2、定位当前活跃的库：通过读取 Obsidian 桌面端的配置文件找到打开的库，而不是在脚本里写死路径。

3、通过 obsidian-cli 提供搜索、创建、移动/重命名、删除四类命令式能力。

4、移动或重命名笔记时，自动更新全库范围内的 [[wikilinks]] 和常见 Markdown 链接——这是相比直接 mv 的主要优势。

安装与启用¶

官方安装命令如下，通过 OpenClaw 的 skills 子命令安装：

$ openclaw skills install @terryren2024/obsidian-1-0-0

也可以使用页面给出的等价方式：

$ npx skills install @terryren2024/obsidian-1-0-0

安装后在 Agent 的 Skill 配置中启用该 Skill 即可。官方资料未区分 Cursor / Codex CLI / Claude Code 的具体接入差异，此处不做推测。

典型用法¶

先看库结构，了解典型布局：

Notes: *.md（纯文本 Markdown，任意编辑器可改）
Config: .obsidian/（工作区与插件设置，脚本一般不动）
Canvases: *.canvas（JSON）
Attachments: 你在 Obsidian 设置里选的目录（图片/PDF 等）

第一步，找到活跃的库。Obsidian 桌面端在如下位置记录已打开的库：

~/Library/Application Support/obsidian/obsidian.json

obsidian-cli 会从该文件解析库；库名通常是文件夹名（路径后缀）。如果你已经设置过默认库，可以直接查询：

obsidian-cli print-default --path-only

否则读取上面的配置文件，取 "open": true 的那个库条目。

第二步，设置默认库（只需一次）：

obsidian-cli set-default "<vault-folder-name>"

验证：

obsidian-cli print-default
obsidian-cli print-default --path-only

第三步，搜索笔记。search 按笔记名匹配，search-content 在笔记正文里匹配并显示片段和行号：

obsidian-cli search "query"
obsidian-cli search-content "query"

第四步，创建笔记。注意这一步需要 Obsidian URI handler（obsidian://…）可用，即本机安装了 Obsidian：

obsidian-cli create "Folder/New note" --content "..." --open

第五步，移动或重命名笔记。这会在全库范围内更新 [[wikilinks]] 和常见 Markdown 链接，是相对直接 mv 的主要收益：

obsidian-cli move "old/path/note" "new/path/note"

第六步，删除笔记：

obsidian-cli delete "path/note"

另外，如果只是小改动，直接编辑 .md 文件即可，Obsidian 会自动识别变化。

适用场景与注意¶

适合：需要批量重命名笔记并维护双链完整性的人；想让 Agent 自动整理、检索笔记库的人；希望用脚本而不是手动点界面完成重复操作的人。

注意事项：

1、多个库并存很常见（比如 iCloud 与本地目录、工作与个人分开）。不要猜，先读配置确认当前活跃的是哪个库。

2、避免在脚本里写死库的绝对路径，优先用 print-default 或读配置文件。

3、create 依赖 Obsidian URI handler 工作，本机必须安装并正常注册 Obsidian。

4、通过 URI 创建笔记时，避免放在隐藏的点目录（如 .something/...）下，Obsidian 可能会拒绝。

5、该 Skill 来自社区发布（clawhub 来源），安装前建议核对上游仓库与安全审计状态。

结尾¶

这个 Skill 的价值在于把 Obsidian 库还原成磁盘上的普通文件夹，同时补上 obsidian-cli 在创建、移动、搜索上的自动化能力，尤其移动时的链接维护比直接操作文件省心。如果你已经在用 Obsidian 管理笔记，又想让它被脚本和 Agent 接管一部分操作，可以从设置默认库这一步开始试。

官方地址：https://api.skillhub.cn/zcwl/obsidian-1-0-0