Connect your AI agent to your Obsidian vault for seamless note creation, fuzzy searching, and automated knowledge management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obsidian-direct
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-direct 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 Knowledge Base?
The Obsidian skill for Openclaw Skills enables AI agents to interact directly with Markdown-based vaults. It provides a robust interface for querying personal knowledge, saving new documents, and editing existing notes using natural language instructions. By integrating with Openclaw Skills, users can transform their static notes into a dynamic, AI-accessible brain that supports complex organizational workflows.
This skill is designed for developers and researchers who use Obsidian as their primary Personal Knowledge Management (PKM) tool. It handles the heavy lifting of folder detection, tag management, and frontmatter manipulation, allowing the agent to focus on synthesizing and retrieving information accurately.
Obsidian Knowledge Base Use Cases
- Querying a personal knowledge base to provide context for AI-generated answers.
- Automatically saving and categorizing new research notes or meeting transcripts.
- Refactoring existing notes by appending summaries or replacing specific sections via AI prompts.
- Managing complex vault structures through automated folder suggestions and wikilink maintenance.
How Obsidian Knowledge Base Works
- The agent identifies the target vault through the OBSIDIAN_VAULT environment variable configuration.
- For information retrieval, it utilizes obsidian_search.py, which leverages ripgrep for high-speed fuzzy and phonetic content matching.
- For note creation, the agent can either use a specified path or invoke the suggest-folder command to determine the best location based on content analysis.
- Note updates are performed via obsidian_cli.py, which supports granular edits like appending, prepending, or replacing specific headers.
- The skill automatically manages YAML frontmatter, ensuring that tags, aliases, and timestamps remain consistent across the vault.
Obsidian Knowledge Base Setup
To get started with this skill in Openclaw Skills, configure your environment and navigate to the script directory:
# Set the path to your Obsidian vault
export OBSIDIAN_VAULT="/path/to/your/vault"
# Navigate to the skills workspace
cd ~/.openclaw/workspace/skills/obsidian/scripts
# Verify the installation by listing folders
python3 obsidian_cli.py --json folders
Obsidian Knowledge Base Data Schema & Taxonomy
The skill interacts with standard Markdown files featuring YAML frontmatter. It organizes data using the following schema:
| Feature | Implementation | Description |
|---|---|---|
| Frontmatter | YAML | Stores created, modified, tags, and aliases. |
| Links | [[Wikilinks]] |
Supports standard and aliased internal vault links. |
| Search Index | ripgrep | Performs fast filtering on titles, tags, and content. |
| Formatting | Markdown | Maintains standard Markdown syntax for cross-app compatibility. |
Obsidian Knowledge Base Advanced Features
- Phonetic search support (RU↔EN) to find notes even with language transliteration or typos.
- Section-aware editing, allowing the agent to modify specific headers without affecting the rest of the document.
- Automated folder detection that analyzes content to suggest the most logical storage location.
- Support for incoming and outgoing link analysis to map knowledge graph relationships.
SKILL.md
Loading
Related Openclaw Skills
Obsidian Knowledge Base
A comprehensive AI skill for managing Obsidian vaults through intelligent search, automated organization, and granular content editing.
Dzen Publisher
A professional automation tool for programmatically publishing rich media posts and articles to the Dzen.ru platform.
Avito
A comprehensive API integration for managing Avito.ru accounts, listings, and messenger communications through automated workflows.
Session Cost Tracker
A specialized monitoring tool that tracks the economic efficiency and tangible value of AI agent sessions to prevent token wastage.
Pinterest API v5 Integration
A comprehensive Pinterest API v5 integration for automating pin creation, board management, and performance tracking.
Threads API Integration
A professional CLI tool for managing Threads profiles and automating content publication via the Graph API.
Featured*
