教程 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。