A powerful integration for managing Obsidian vaults, enabling automated note creation, searching, and link-safe refactoring via the command line.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mh-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 mh-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 Vault Automation?
The Obsidian skill provides a bridge between AI agents and your local Markdown-based knowledge base. Since an Obsidian vault is essentially a folder of plain text files, this skill leverages obsidian-cli to perform high-level operations that go beyond simple file editing. By integrating this into Openclaw Skills, developers can automate the organization of their personal knowledge management systems while maintaining the integrity of their data.
This skill is designed to handle the nuances of the Obsidian ecosystem, such as managing wikilinks during file moves and identifying active vaults from the application's internal configuration. It allows for a more structured approach to interacting with Markdown notes, making it an essential tool for any automated research or documentation workflow.
Obsidian Vault Automation Use Cases
- Automating the creation of daily notes or meeting minutes with pre-defined templates.
- Performing deep-content searches across a large vault to retrieve specific technical snippets.
- Refactoring vault structure by moving notes without breaking internal [[wikilinks]].
- Programmatically identifying the current active vault in a multi-vault setup.
How Obsidian Vault Automation Works
- The skill detects the active vault path by reading the obsidian.json configuration file located in the user's Application Support directory.
- It utilizes the obsidian-cli to execute specific vault operations like searching or creating notes via the Obsidian URI handler.
- For organizational tasks, the skill uses the move command to ensure that all internal Markdown links are updated vault-wide.
- Direct file system edits can be performed on .md files, which Obsidian instantly reflects in the desktop application.
Obsidian Vault Automation Setup
To use this skill, you must have the obsidian-cli installed. You can install it using Homebrew:
brew tap yakitrak/yakitrak
brew install obsidian-cli
Once installed, set your default vault to allow the Openclaw Skills integration to target the correct folder:
obsidian-cli set-default "<your-vault-folder-name>"
Obsidian Vault Automation Data Schema & Taxonomy
The skill interacts with the standard Obsidian vault structure and metadata files:
| Component | Type | Description |
|---|---|---|
| Notes | .md | Plain text Markdown files containing your content and wikilinks. |
| Canvases | .canvas | JSON-formatted files used for Obsidian's visual layout tool. |
| Config | .obsidian/ | A hidden directory containing workspace and plugin settings. |
| Application Config | obsidian.json | Tracks the paths and open status of all registered vaults on the system. |
Obsidian Vault Automation Advanced Features
- Intelligent Refactoring: Automatically updates all [[wikilinks]] across the entire vault when a file is moved or renamed.
- Deep Content Search: Search through note contents, not just filenames, with line-specific result snippets.
- Multi-Vault Support: Dynamically resolves the active vault path instead of relying on hardcoded directory strings.
- URI Integration: Trigger Obsidian's internal UI actions directly from Openclaw Skills using the official URI handler.
SKILL.md
Loading
Related Openclaw Skills
Notion
A professional-grade integration for Openclaw Skills to programmatically manage Notion pages, data sources, and content blocks.
Healthcheck: Host Security Hardening
A dedicated security auditing and host hardening skill for Openclaw Skills deployments that balances risk tolerance with system usability.
blogwatcher
A lightweight CLI utility for tracking and managing updates from blogs and RSS/Atom feeds.
Bear Notes
A specialized skill for programmatically managing Bear notes on macOS using the grizzly CLI and x-callback-url integration.
OpenAI Whisper API Transcription
A command-line utility for high-accuracy audio transcription leveraging the OpenAI Whisper API via Openclaw Skills.
OpenAI Whisper (CLI)
A high-performance local speech-to-text engine that transcribes audio files without requiring an internet connection or API keys.
session-logs
Empower your AI agent to search, filter, and analyze its own historical conversation logs and usage metrics.
Featured*
