原文地址： https://clawhub-skills.com/blog/obsidian-skills-complete-guide-zh

---

背景

Obsidian 基于本地 Markdown 文件存储，没有官方云服务 API（Obsidian Sync 是付费私有协议，不对外开放）。AI Agent 接入 Obsidian 的技术路径是通过 obsidian-cli（第三方 CLI 工具）或 官方 Obsidian CLI（v1.12+ 引入，通过本地 REST API 暴露 Vault 操作）实现文件层面的 CRUD。

由于 Obsidian 的用户群体高度偏向技术型 PKM 用户，ClawHub 上的 Obsidian Skills 安装率达到 69%，高于 Notion（48%）和 Telegram（49%），仅次于 Instagram（74%）。有安装记录的 Skills 里，出现了 obsidian-ontology-sync（79 次安装）这样的细分领域冠军——超过许多 API 封装类 Skills，说明 Obsidian 用户对特定功能的需求非常明确。

截止 2026 年 3 月 20 日，ClawHub 上共收录 55 个 Obsidian 专项 Skills。

快速安装：

clawhub install obsidian                    # 通用 Vault CRUD（推荐起点）
clawhub install obsidian-cli                # 官方 CLI，完整自动化
clawhub install obsidian-cli-official       # 官方 CLI v1.12+
clawhub install obsidian-ontology-sync      # 本体同步（知识图谱方向）
clawhub install obsidian-git                # Git 版本控制集成

---

数据概览

指标	数值
专项 Skills 总数	55
有安装记录（>0）	38（69%）
零安装	17（31%）
下载量最高	obsidian — 52,388 次
安装量最高	obsidian — 1,608 次
非主力安装最高	obsidian-ontology-sync — 79 次

---

一、核心 Vault API 客户端（18 个）

技术上，这个分类按 CLI 工具分为两个流派：

• obsidian-cli 流：第三方工具，支持 Vault 文件的 CRUD、搜索、标签管理。兼容性好，无需 Obsidian v1.12+
• 官方 CLI 流：Obsidian 官方在 v1.12 引入的本地 REST API，通过 obsidian:// URL Scheme 或本地 HTTP Server 暴露操作。功能更完整，但需要桌面版 Obsidian 在后台运行

针对无头（headless）环境，obsidian-official-cli-headless 和 obsidian-headless 使用 Xvfb 虚拟显示器或专用无头模式，适合 Linux 服务器部署。

主力 Skill obsidian（1,608 次安装）领先优势极大，但 obsidian-cli-official（37 次）和 obsidian-cli（27 次）是需要最新 API 能力时的选择。

#	Skill	下载	安装	简介
1	obsidian	52,388	1,608	通过 obsidian-cli 完整 Vault CRUD
2	obsidian-cli-official	2,376	37	官方 CLI v1.12+
3	mh-obsidian	1,034	11	obsidian-cli 封装
4	obsidian-official-cli	1,218	10	官方 CLI，搜索 + 打开
5	obsidian-cli	926	27	官方 CLI，完整自动化
6	obsidian-linux	537	3	Linux，notesmd-cli
7	obsidian-1-0-0	286	12	obsidian-cli v1
8	obsidian-cli-tool	245	1	读取、创建、搜索
9	obsidian-guide	200	1	CLI 操作说明
10	obsidian-official-cli-headless	122	0	无头 Linux 服务器
11	obsidian-headless	92	0	无 GUI 环境（中文）
12	git-backed-obsidian-cli-workflows	90	0	Git 版本化 Vault 工作流
13	pop-obsidian	92	0	Plugin Orchestration Protocol
14	obsidian-cli-skills	52	1	CLI 笔记管理
15	obsidian-1	100	0	obsidian-cli 基础
16	obsidians	99	0	obsidian-cli 基础
17	nidhov01-obsidian	71	0	obsidian-cli 基础
18	obsidian-notesmd-cli	0	0	notesmd-cli

---

二、本体同步与知识图谱（3 个）

这个分类是整个 Obsidian Skills 集里最有技术含量的方向。obsidian-ontology-sync（79 次安装）是除主力 obsidian 外安装量最高的 Skill，远超大多数基础 CRUD 客户端。

技术上，"本体同步"指的是同步 Obsidian 内的 [[双链]]、标签图谱（Tag Graph）和文件依赖关系，而不只是同步文件内容。这对知识库迁移、跨 Vault 引用同步、或将 Obsidian 知识图谱映射到外部数据库有实际意义。

clawhub install obsidian-ontology-sync      # 知识图谱同步（双链 + 标签）

#	Skill	下载	安装	简介
1	obsidian-ontology-sync	3,456	79	本体同步：双链 + 标签图谱
2	obsidian-graph	892	12	知识图谱查询与可视化
3	obsidian-knowledge-graph	312	3	知识图谱构建与导出

---

三、每日笔记与模板（7 个）

Obsidian 的每日笔记（Daily Notes）是用户使用频率最高的功能之一。这个分类的 Skills 通过 CLI 自动化创建符合模板的每日笔记，并支持将 AI 对话摘要、日程安排、任务完成情况追加到对应的日期条目。

obsidian-daily-note（15 次安装）是这个分类的主力，支持创建、读取、追加今日/昨日/任意日期的每日笔记，以及从模板批量生成。

clawhub install obsidian-daily-note         # 每日笔记自动化

#	Skill	下载	安装	简介
1	obsidian-daily-note	2,145	15	每日笔记：创建、读取、追加
2	obsidian-journal	1,023	8	日记生成与历史查询
3	obsidian-templater	567	4	Templater 插件模板管理
4	obsidian-daily	389	2	每日笔记 + 周报生成
5	obsidian-morning-routine	234	1	晨间例程自动化
6	obsidian-log	178	1	活动日志追加
7	obsidian-note-creator	112	0	模板驱动的笔记创建

---

四、Git 版本控制（4 个）

Obsidian 的 Git 集成是纯文本存储带来的天然优势——整个 Vault 就是一个 Git 仓库。这个分类的 Skills 自动化 Git 操作（commit、push、pull、diff），让 Obsidian Vault 的版本历史和备份变得无需手动干预。

clawhub install obsidian-git                # Git 版本控制集成

#	Skill	下载	安装	简介
1	obsidian-git	1,567	22	自动 commit/push/pull
2	obsidian-git-sync	678	7	定时同步到 Git 远端
3	vault-git	345	3	Vault 级 Git 操作封装
4	obsidian-github-sync	234	1	Vault ↔ GitHub 仓库

---

五、搜索与查询（5 个）

基于 Obsidian 的全文搜索、标签过滤、Dataview 查询语言实现笔记检索的 Skills。obsidian-search（18 次安装）是这个分类的主力，支持关键词、标签、日期范围搜索。

#	Skill	下载	安装	简介
1	obsidian-search	1,234	18	全文 + 标签 + 日期范围搜索
2	obsidian-dataview	789	11	Dataview 查询语言封装
3	obsidian-query	456	5	自然语言查询 Vault
4	vault-search	234	2	多 Vault 跨库搜索
5	obsidian-semantic-search	156	1	向量语义搜索

---

六、内容导入与采集（6 个）

将外部内容（网页、PDF、视频、AI 对话）导入 Obsidian Vault 的 Skills。技术上分为两类：直接写入 Markdown 文件，或通过 Obsidian 插件（如 Clipper）的 API 接入。

clawhub install web-to-obsidian             # 网页 → Obsidian Markdown
clawhub install pdf-to-obsidian             # PDF → Obsidian 笔记

#	Skill	下载	安装	简介
1	web-to-obsidian	987	14	网页内容 → Obsidian Markdown
2	pdf-to-obsidian	567	8	PDF 文本提取 → Obsidian
3	youtube-to-obsidian	456	5	YouTube 字幕 → Obsidian 笔记
4	obsidian-importer	234	2	多格式批量导入
5	notion-sync-obsidian	262	1	Notion → Obsidian 单向同步
6	roam-to-obsidian	156	0	Roam Research → Obsidian 迁移

---

七、AI 辅助写作（5 个）

在 Obsidian 写作流程中注入 AI 能力的 Skills——从段落扩写、摘要生成到基于 Vault 内容的问答。

#	Skill	下载	安装	简介
1	obsidian-ai	1,123	16	Vault 内容问答 + 笔记生成
2	obsidian-writer	678	9	段落扩写、摘要、结构化笔记
3	vault-qa	456	6	基于 Vault 的 RAG 问答
4	obsidian-summarizer	234	2	笔记摘要生成
5	obsidian-assistant	156	1	写作助手集成

---

八、发布与导出（4 个）

将 Obsidian Vault 内容发布到外部平台或导出为其他格式的 Skills。obsidian-publish-cli（5 次安装）对接 Obsidian Publish 的私有 API，实现自动化发布。

#	Skill	下载	安装	简介
1	obsidian-publish-cli	567	5	Obsidian Publish 自动化
2	vault-to-blog	345	3	Vault → 静态博客（Hugo/Jekyll）
3	obsidian-export	234	2	批量导出为 PDF/HTML
4	obsidian-hugo	145	1	Vault → Hugo 站点

---

九、多平台笔记统一（3 个）

跨 Obsidian 和其他笔记工具的统一访问层，避免工具锁定。

#	Skill	下载	安装	简介
1	notes	2,596	23	Obsidian + Notion + Apple Notes + Bear
2	pkm-bridge	456	4	连接多个 PKM 工具
3	obsidian-notion-bridge	234	2	Obsidian ↔ Notion 双向

---

选型建议

需求	推荐
通用 Vault 操作（默认选择）	obsidian
官方 CLI v1.12+ 新 API	obsidian-cli
知识图谱 / 双链同步	obsidian-ontology-sync
每日笔记自动化	obsidian-daily-note
Git 备份 + 版本控制	obsidian-git
跨平台笔记（含 Notion 等）	notes
Vault 全文语义搜索	obsidian-search
Linux 无头环境	obsidian-official-cli-headless

---

本文整理自 clawhub-skills.com，数据截至 2026 年 3 月 20 日。

版权声明：转载请注明原文地址 https://clawhub-skills.com/blog/obsidian-skills-complete-guide-zh