教程 20 — OpenClaw Obsidian Skill 教程：让 AI 自动写笔记、整理 Vault、创建双向链接（2026）
目标：安装 Obsidian Skill，通过 obsidian-cli 让 OpenClaw 用自然语言操作 Obsidian Vault：读写笔记、创建链接、整理文件夹。
什么是 Obsidian Skill？
Obsidian Skill 是 ClawHub 上的热门知识管理 Skill（68k 下载），通过 obsidian-cli 桥接 OpenClaw 与本地 Obsidian Vault。安装后，你可以用一句话让 AI 完成原本需要手动操作的笔记任务：自动写每日笔记、批量整理文件夹、创建双向链接网络。
SEO 关键词覆盖：openclaw 自动写 obsidian 笔记、ai 帮我整理 obsidian vault 文件夹、obsidian-cli 配合 openclaw 使用教程
第一步：安装依赖 CLI 工具
Obsidian Skill 依赖 obsidian-cli，先全局安装：
npm install -g obsidian-cli验证安装：
obsidian-cli --version
# 应该输出版本号，如 1.5.3macOS 用户如果遇到 Gatekeeper 报错，执行：
xattr -d com.apple.quarantine $(which obsidian-cli)第二步：安装 Skill 并配置 Vault 路径
在 WebChat 或 Telegram 中发送：
/install @steipete/obsidian
安装完成后配置你的 Vault 路径：
/config obsidian vault_path ~/Documents/MyVault
或者通过命令行直接写入配置：
pnpm openclaw config set obsidian.vault_path "/Users/yourname/Documents/MyVault"验证 Skill 可以访问 Vault：
pnpm openclaw skills list
# 确认 obsidian 在列表中
# 测试连通性
obsidian-cli --vault ~/Documents/MyVault list第三步：读取现有笔记
安装后即可用自然语言查询 Vault 内容：
搜索我的 Obsidian Vault 里所有提到"项目管理"的笔记
按标签过滤：
列出所有带 #todo 标签的笔记，按修改时间排序
读取具体笔记：
读取 Vault 里的"2026-01-15 每日回顾"这篇笔记
批量搜索关键词：
obsidian-cli --vault ~/Documents/MyVault search "OpenClaw" --tag "技术" --limit 20openclaw 自动写 obsidian 笔记 的前提是先让 AI 了解你现有的笔记结构，可以让它先执行一次全 Vault 的目录扫描。
第四步：创建新笔记（含 frontmatter 和双向链接）
让 AI 帮你创建一篇结构完整的笔记：
在 Obsidian 的"Projects/OpenClaw"文件夹里创建一篇新笔记，标题是"MCP 集成方案"，
添加 frontmatter（tags: [技术, MCP], created: 2026-03-30），
正文写这篇笔记的大纲，并链接到我 Vault 里已有的"API 设计原则"笔记
生成的笔记格式示例：
---
tags: [技术, MCP]
created: 2026-03-30
status: draft
---
# MCP 集成方案
## 背景
参考 [[API 设计原则]] 中关于接口规范的讨论...
## 方案设计
- [ ] 确定 MCP Server 部署方式
- [ ] 配置认证机制
## 相关笔记
[[OpenClaw 架构]] | [[Skill 开发指南]]openclaw obsidian 双向链接 自动生成 的关键在于：告诉 AI 你想链接哪些已有笔记，它会自动生成 [[]] 格式的 Wiki 链接。
第五步：整理 Vault（批量重命名和移动）
批量整理混乱的笔记文件夹：
把 Vault 根目录里所有包含日期（格式如 2025-xx-xx）的笔记移动到"Daily Notes/2025"文件夹
批量重命名：
把"Inbox"文件夹里所有笔记，根据正文第一行的 H1 标题重命名文件名
整理标签：
扫描整个 Vault，找出没有 frontmatter 的笔记，逐一添加 tags 和 created 字段
命令行批量操作：
obsidian-cli --vault ~/Documents/MyVault organize \
--move-pattern "^\d{4}-\d{2}-\d{2}" \
--target "Daily Notes/2025"第六步：每日工作流——自动写 Daily Note
这是最受欢迎的使用场景之一。在每天下班前发送：
帮我写今天的 Obsidian Daily Note（2026-03-30），
内容包括：今天完成的工作、遇到的问题、明天的计划，
格式用 Obsidian 标准模板，自动链接到相关项目笔记
或者配合定时任务（参考 Lesson 06），每天 18:00 自动触发：
# crontab -e 添加
0 18 * * * pnpm openclaw run "写今天的 Obsidian Daily Note，从日历和任务系统拉取今日数据"openclaw 每天自动总结 保存到 obsidian 的完整流程：AI 读取当天的 Git commit、日历事件 → 整理成笔记 → 写入 Daily Note → 自动链接相关项目。
第七步：和 Summarize Skill 组合使用
把 Lesson 10 的 Summarize Skill 和 Obsidian Skill 串联：
总结这篇文章并保存到 Obsidian：
https://example.com/interesting-article
保存到"Reading Notes"文件夹，标题用文章标题，
添加 tags: [阅读, 技术]，在正文末尾加上原文链接
一键完成"读网页 → 提取要点 → 存笔记"的完整流程，实现 ai 帮我整理 obsidian vault 文件夹 的自动化知识管理体系。
常见问题
OpenClaw 能直接读写 Obsidian 的 Markdown 文件吗？
可以。Obsidian 的笔记本质上是本地 Markdown 文件，obsidian-cli 直接操作文件系统，不依赖 Obsidian App 是否打开。OpenClaw 通过 obsidian-cli 读写文件后，下次你打开 Obsidian App 时会自动看到新内容。唯一的前提是 OpenClaw 运行的机器能访问 Vault 所在的目录路径（本地或网络挂载路径均可）。
Obsidian Skill 需要安装什么 Obsidian 插件吗？
不需要任何 Obsidian 插件。Obsidian Skill 通过 obsidian-cli 直接操作 Vault 的文件系统，完全绕过 Obsidian App 的插件体系。这意味着即使你没有安装 Obsidian（比如在服务器上运行 OpenClaw），Skill 也能正常工作。如果你使用 Dataview 或 Templater 等插件，AI 创建的笔记会在你下次打开 Obsidian 时被这些插件正常处理。
AI 创建的笔记会覆盖我已有的内容吗？
默认不会。Obsidian Skill 在写入前会检查目标路径是否已有同名文件，如果存在则提示你确认是否覆盖或追加内容。如果你想让 AI 向已有笔记追加内容（比如每天追加到 Daily Note），明确说"追加到"而不是"创建"即可。建议在首次使用时先在 Vault 的非重要文件夹测试，熟悉 AI 的操作行为后再应用到核心笔记。
支持 Obsidian Sync 同步的 Vault 吗？
支持。Obsidian Sync 只是在本地文件系统基础上增加了云同步，obsidian-cli 读写的是本地文件，不会影响同步机制。AI 写入笔记后，Obsidian Sync 会在下次 App 启动时自动把新文件同步到你的其他设备。注意：如果 OpenClaw 和 Obsidian App 同时在写同一个文件，可能产生冲突，建议在 AI 批量操作时关闭 Obsidian App。