🕸️

Obsidian

通过 obsidian-cli 搜索、创建、移动与编辑 Markdown 笔记,并自动重构 Obsidian 的 wikilink。

作者

Peter Steinberger

浏览器与自动化生产力自动化CLI
安装
npx clawhub@latest install obsidian
Star 数

145

下载次数

34.7k

当前安装数

0

累计安装数

874

版本

v1.0.0

更新时间

Mar 5, 2026

使用要求

obsidian-cli · Obsidian 桌面版

查看源码

ClawHub

Obsidian 介绍

Obsidian 技能让 AI 助手可以直接操作 Obsidian vault,它们本质上是磁盘上的 Markdown 文件夹。

它支持搜索、创建、移动/重命名并自动更新链接,还可直接编辑 Markdown 文件。

工作原理

1Step 1 - 发现 Vault

读取 Obsidian 配置以定位已启用的 vault,支持多 vault。

2Step 2 - 搜索与创建

使用 obsidian-cli 按名称或内容搜索,并在任意目录创建新笔记。

3Step 3 - 安全重命名

移动或重命名时会自动更新整个 vault 的 [[wikilinks]] 与 Markdown 链接。

4Step 4 - 直接编辑

直接编辑 .md 文件,Obsidian 会自动读取变更。

关键特性

Vault 发现

自动读取 Obsidian 配置以发现 vault,支持多 vault 场景。

笔记搜索

按名称或内容搜索,返回片段与行号。

安全重命名与移动

自动重构 [[wikilinks]] 与 Markdown 链接。

笔记创建

在任意文件夹创建新笔记,并可选择自动在 Obsidian 中打开。

直接编辑文件

直接编辑 Markdown 文件,Obsidian 可即时同步。

默认 Vault 管理

设置并查询默认 vault,避免重复指定路径。

使用要求

  • 无需 VM。
  • 需要 obsidian-cli,可通过 Homebrew 安装。
  • 需要安装 Obsidian 桌面版(用于 URI 处理与自动打开)。

使用场景

知识管理

组织、搜索并更新个人知识库。

笔记自动化

自动生成每日笔记、会议纪要或项目日志。

Vault 重构

安全重构 vault 结构并自动更新链接。

内容检索

通过全文搜索快速定位信息。

如何安装

npx clawhub@latest install obsidian

在终端运行上述命令,或点击页面顶部的安装按钮完成一键安装。

常见问题

需要安装 Obsidian 吗?

若要使用 URI 自动打开功能,需要安装 Obsidian;其他操作可直接处理 vault 文件。

vault 是从哪里读取的?

从 `~/Library/Application Support/obsidian/obsidian.json` 读取配置并发现 vault。

重命名会更新链接吗?

会。obsidian-cli 会更新整个 vault 的 [[wikilinks]] 与 Markdown 链接。

如何设置默认 vault?

使用 `obsidian-cli set-default`,并用 `obsidian-cli print-default` 查看。

可以按内容搜索吗?

可以,使用 `obsidian-cli search-content` 返回匹配片段与行号。

多 vault 场景支持吗?

支持,可指定 vault 或设置默认 vault。