A powerful automation interface for Obsidian vaults that enables seamless note management and refactoring via CLI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obsidian
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install obsidian using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Obsidian?
The Obsidian skill allows AI agents and developers to interact directly with local Obsidian vaults, which are fundamentally folders of plain Markdown files. By leveraging the obsidian-cli, this skill provides a bridge between structured automation and personal knowledge management. Users can programmatically manage their notes, search through vast amounts of information, and maintain vault integrity through Openclaw Skills. It emphasizes the flexibility of Markdown while providing the structure needed for sophisticated agentic workflows.
Obsidian Use Cases
- Searching note titles and deep content snippets within a personal knowledge base.
- Automating the creation of new notes with specific templates or content via CLI.
- Safe refactoring of vault structures by moving notes while automatically updating all internal wikilinks.
- Discovering active vault paths and configurations on macOS systems for dynamic script execution.
How Obsidian Works
- The skill resolves the active vault location by reading the obsidian.json configuration file located in the application support directory.
- It utilizes obsidian-cli to execute high-level operations like search-content and vault-wide moves.
- For creation tasks, it triggers the Obsidian URI handler to ensure the desktop application correctly registers and opens new files.
- It interacts directly with the file system for standard Markdown edits, ensuring that Openclaw Skills can update content without requiring the GUI to be active.
Obsidian Setup
To get started, you must install the obsidian-cli utility. Use the following commands to set up the environment for Openclaw Skills:
# Install obsidian-cli via Homebrew
brew tap yakitrak/yakitrak
brew install obsidian-cli
# Set your default vault for automation
obsidian-cli set-default "your-vault-folder-name"
Ensure that Obsidian is installed on your system to allow the URI handler to function correctly.
Obsidian Data Schema & Taxonomy
The skill interacts with the standard Obsidian vault directory structure to ensure compatibility and data integrity:
| File Type | Format | Purpose |
|---|---|---|
| Notes | .md | Plain text Markdown files containing user content and metadata. |
| Configuration | .obsidian/ | Folder containing workspace, plugin, and theme settings. |
| Canvases | .canvas | JSON-based files for visual layouts and diagrams. |
| App Config | obsidian.json | Global registry of vault paths and the currently open vault. |
Obsidian Advanced Features
- Automated wikilink refactoring that updates [[wikilinks]] across the entire vault when a file is moved.
- High-speed content indexing and searching for rapid information retrieval via Openclaw Skills.
- Support for multiple vault management, allowing scripts to switch contexts between work and personal notes.
- Safe-delete protocols and folder-aware note creation to prevent data loss or directory clutter.
SKILL.md
Loading
Related Openclaw Skills
Notion API Integration
A comprehensive tool for programmatically managing Notion pages, data sources, and content blocks via the Notion API.
Native App Performance Profiling
A CLI-first approach to profiling macOS and iOS application performance using xctrace and automated symbolication scripts.
nano-pdf
A command-line utility that enables PDF page editing through natural language instructions.
Nano Banana Pro
A high-performance AI tool for generating and editing images using the Google Gemini 3 Pro Image API.
OpenAI Image Gen
Batch-generate AI images using OpenAI with automated prompt sampling and a built-in HTML gallery.
OpenAI Whisper API Transcription
A high-performance CLI skill for transcribing audio files using OpenAI's Whisper model via the Openclaw Skills framework.
Featured*
