Obsidian：自动化 Markdown 库与笔记 - Openclaw Skills

下载入口:https://github.com/openclaw/skills/tree/main/skills/steipete/obsidian

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install obsidian

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 obsidian。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

什么是 Obsidian？

Obsidian 技能允许 AI 智能体和开发者直接与本地 Obsidian 仓库（本质上是纯 Markdown 文件文件夹）进行交互。通过利用 obsidian-cli，该技能在结构化自动化与个人知识管理之间架起了一座桥梁。用户可以通过 Openclaw Skills 以编程方式管理笔记、搜索海量信息并维护仓库完整性。它在强调 Markdown 灵活性的同时，也为复杂的智能体工作流提供了所需的结构。

Obsidian 应用场景

• 在个人知识库中搜索笔记标题和深度内容片段。
• 通过 CLI 使用特定模板或内容自动创建新笔记。
• 通过移动笔记并自动更新所有内部双链（wikilinks），实现仓库结构的跨目录重构。
• 在 macOS 系统上发现活动仓库路径和配置，以进行动态脚本执行。

Obsidian 工作原理

1. 该技能通过读取位于应用支持目录中的 obsidian.json 配置文件来解析活动仓库位置。
2. 它利用 obsidian-cli 执行高级操作，如内容搜索和全库移动。
3. 对于创建任务，它会触发 Obsidian URI 处理器，以确保桌面应用程序正确注册并打开新文件。
4. 它直接与文件系统进行交互以进行标准 Markdown 编辑，确保 Openclaw Skills 可以在不需要 GUI 处于活动状态的情况下更新内容。

Obsidian 配置指南

要开始使用，您必须安装 obsidian-cli 工具。使用以下命令为 Openclaw Skills 设置环境：

# 通过 Homebrew 安装 obsidian-cli
brew tap yakitrak/yakitrak
brew install obsidian-cli

# 设置自动化的默认仓库
obsidian-cli set-default "your-vault-folder-name"

确保您的系统中已安装 Obsidian，以便 URI 处理器能够正常工作。

Obsidian 数据架构与分类体系

该技能与标准的 Obsidian 仓库目录结构进行交互，以确保兼容性和数据完整性：

文件类型	格式	用途
笔记	.md	包含用户内容和元数据的纯文本 Markdown 文件。
配置	.obsidian/	包含工作区、插件和主题设置的文件夹。
画布	.canvas	用于可视化布局和图表的基于 JSON 的文件。
应用配置	obsidian.json	仓库路径和当前打开仓库的全局注册表。

name: obsidian
description: Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
homepage: https://help.obsidian.md
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["obsidian-cli"]},"install":[{"id":"brew","kind":"brew","formula":"yakitrak/yakitrak/obsidian-cli","bins":["obsidian-cli"],"label":"Install obsidian-cli (brew)"}]}}

Obsidian

Obsidian vault = a normal folder on disk.

Vault structure (typical)

• Notes: *.md (plain text Markdown; edit with any editor)
• Config: .obsidian/ (workspace + plugin settings; usually don’t touch from scripts)
• Canvases: *.canvas (JSON)
• Attachments: whatever folder you chose in Obsidian settings (images/PDFs/etc.)

Find the active vault(s)

Obsidian desktop tracks vaults here (source of truth):

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

obsidian-cli resolves vaults from that file; vault name is typically the folder name (path suffix).

Fast “what vault is active / where are the notes?”

• If you’ve already set a default: obsidian-cli print-default --path-only
• Otherwise, read ~/Library/Application Support/obsidian/obsidian.json and use the vault entry with "open": true.

Notes

• Multiple vaults common (iCloud vs ~/Documents, work/personal, etc.). Don’t guess; read config.
• Avoid writing hardcoded vault paths into scripts; prefer reading the config or using print-default.

obsidian-cli quick start

Pick a default vault (once):

• obsidian-cli set-default "<vault-folder-name>"
• obsidian-cli print-default / obsidian-cli print-default --path-only

Search

• obsidian-cli search "query" (note names)
• obsidian-cli search-content "query" (inside notes; shows snippets + lines)

Create

• obsidian-cli create "Folder/New note" --content "..." --open
• Requires Obsidian URI handler (obsidian://…) working (Obsidian installed).
• Avoid creating notes under “hidden” dot-folders (e.g. .something/...) via URI; Obsidian may refuse.

Move/rename (safe refactor)

• obsidian-cli move "old/path/note" "new/path/note"
• Updates [[wikilinks]] and common Markdown links across the vault (this is the main win vs mv).

Delete

• obsidian-cli delete "path/note"

Prefer direct edits when appropriate: open the .md file and change it; Obsidian will pick it up.