A robust command-line interface for programmatically interacting with Obsidian vaults via Inter-Process Communication.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obsidian-guide
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-guide 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 CLI Automation?
The Obsidian CLI skill provides a powerful bridge between your local terminal and the Obsidian desktop application. It utilizes Inter-Process Communication (IPC) to allow AI agents and developers to manipulate notes, manage tasks, and query vault data without manual intervention. By integrating this into the Openclaw Skills ecosystem, users can build automated workflows that turn their static knowledge base into a dynamic, agent-accessible data source.
This skill is designed for version 1.12 and above of Obsidian, ensuring high-performance communication with the client. It enables a wide range of actions from simple note reading to complex metadata management, making it a cornerstone for anyone looking to automate their personal knowledge management system.
Obsidian CLI Automation Use Cases
- Automating the creation of daily notes and logging recurring tasks.
- Performing bulk updates to note properties and frontmatter metadata.
- Searching through large-scale vaults to retrieve specific information for AI agents.
- Managing task lists across multiple files with programmatic toggle and completion features.
- Identifying and fixing broken links or finding orphan notes within a complex knowledge graph.
How Obsidian CLI Automation Works
- The Obsidian desktop application must be running in the background with the CLI feature enabled in settings.
- The CLI tool initiates a connection to the Obsidian instance via a local IPC channel.
- Commands issued through the terminal or an agent are parsed and sent to the active vault.
- Obsidian executes the requested file operation, search, or metadata update.
- The CLI returns the result to the caller, supporting structured formats like JSON for further automation.
Obsidian CLI Automation Setup
To use this with Openclaw Skills, follow these installation steps:
- Install Obsidian (v1.12+) from https://obsidian.md/download.
- Inside Obsidian, navigate to Settings -> General -> Enable CLI.
- Clone the skill repository into your local workspace:
git clone https://github.com/kepano/obsidian-skills.git ~/.openclaw/workspace/skills/obsidian-skills
- Restart the gateway to apply changes:
openclaw gateway restart
Obsidian CLI Automation Data Schema & Taxonomy
The skill manages data across your Obsidian vault using the following parameters and output structures:
| Parameter | Description | Syntax Example |
|---|---|---|
file |
Target a note by its name (supports wikilinks) | file=MyNote |
path |
Target a note by its absolute or relative path | path="Folder/Note.md" |
content |
The text body for creation or appending | content="Hello World" |
format |
Defines the output structure (e.g., json) | format=json |
query |
The search string for vault-wide lookups | query="TODO" |
It interacts with standard Markdown files, Obsidian flavored Markdown (OFM), and structured Frontmatter (YAML/Properties).
Obsidian CLI Automation Advanced Features
- Multi-vault support allows targeting specific vaults by providing the vault name as the first argument.
- Context-aware searching provides matching snippets and line numbers for precise information retrieval.
- Programmatic task management enables agents to mark items as done or toggle statuses across the entire vault.
- Metadata analysis tools can list all tags, properties, and their respective counts for data auditing.
- Graph maintenance commands help identify unresolved links and orphan files to keep the knowledge base clean.
SKILL.md
Loading
Related Openclaw Skills
API Design Patterns
A comprehensive guide and implementation toolkit for building consistent, developer-friendly REST APIs using industry-standard patterns.
PaperPod
An isolated, agent-native sandbox providing code execution, browser automation, and 50+ pre-installed tools via CLI or HTTP.
Content Writing & Thought Leadership Agent
A specialized content writing system for AI agents to manage daily B2B thought leadership workflows across Sales, HR, Fintech, and Ops Tech industries.
Personal Branding Authority
A comprehensive framework for building high-authority personal brands on LinkedIn tailored to specific professional roles and industry constraints.
Legacy Story Agent
A specialized AI tool designed to excavate and preserve oral history from older generations through structured interviews and automated script generation.
Voicenotes Integration
A bridge to sync voice recordings, AI-generated transcripts, and summaries from Voicenotes.com into your local developer workspace.
Featured*
