⚡ Obsidian Extension Skill

Featured · Productivity & Tasks

Seamlessly connect and manage your Obsidian knowledge base — supporting smart search, note creation and editing, with automatic [[wikilink]] bi-directional link refactoring via obsidian-cli when moving files.

OpenClaw Team

🚀 Quick Install

Run the following command in your terminal to install:

npx clawhub install obsidian

📊 Stats Overview

⭐ Stars	☁️ Total Downloads	👥 Active Users	🎯 Stable Version
1.5k	523k	6,200	v2.0.1

🎛️ How It Works

This extension skill empowers AI assistants with full access to operate local Obsidian knowledge bases (pure Markdown format). The system automatically parses the obsidian.json config file, perfectly adapting to complex environments with multiple Vaults, iCloud sync, and custom paths:

🔍 Semantic Smart Search: Beyond traditional filename and title matching, it features a built-in vector-based full-text semantic search engine. Even when you only remember a vague snippet of inspiration, it can instantly locate the original note across your entire library.
📝 Intelligent Content Management: Automatically organizes, appends content, or generates new well-formatted notes based on natural language instructions. Supports YAML frontmatter metadata injection, automatic tag categorization, template variable dynamic replacement, and more.
🔗 Cross-link Refactoring: When renaming or moving notes, it automatically traverses and updates all associated [[wikilink]] bi-directional links and ![[embed]] references across the entire vault, eliminating broken links at the source.
📂 Multi-Vault Orchestration: Switch between multiple independent knowledge bases within a single session — ideal for power users managing "Work + Personal + Academic" knowledge domains in parallel.

🧭 Typical Use Cases

🧠 Scenario 1: Personal Knowledge Butler

Use AI as your second-brain manager. Let it automatically organize daily to-dos, extract key arguments from long reads, and autonomously complete bi-directional link refactoring and archiving based on work context.

📅 Scenario 2: Templated Journals & Reviews

Configure it to automatically insert morning planners and evening summary logs with date and tag metadata from templates each day, turning daily inspiration into structured records that form a traceable personal growth chain.

🌲 Scenario 3: Large Vault Restructuring

Facing scattered legacy notes (thousands or even tens of thousands), AI can execute fully safe large-scale multi-level categorization and migration. It first runs a read-only dry run and generates a change preview list, then executes in batch after your confirmation.

⚡ Scenario 4: Natural Language Flash Search

Describe your fuzzy memory fragments to the assistant in plain natural language, and it can instantly locate content across your massive note library, presenting complete historical context and association network graphs.

💻 Command Reference

After installation, you can let AI call these autonomously via conversation, or manually trigger operations from the CLI:

Search within a specified Vault using natural language:

clawhub obsidian search "distributed systems notes" --vault ~/Documents/MyVault

Create a new note with frontmatter metadata:

clawhub obsidian create "Weekly Review" --template weekly-review --tags "review,GTD"

Safely rename a note and automatically update all backlinks across the vault:

clawhub obsidian rename "OldTitle.md" "NewTitle.md" --update-links

Execute cross-folder batch migration (preview first, then confirm):

clawhub obsidian move "inbox/*.md" --to "archive/2026/" --dry-run

🛡️ Requirements & Security

📑 Obsidian Desktop: Requires Obsidian desktop client (v1.4+) pre-installed so the system can correctly use the obsidian:// URI protocol.
🛠️ obsidian-cli: Command-line extension tool. Mac users deploy via brew install obsidian-cli; Windows users use winget install obsidian-cli.
🔒 Local-first: All note operations are performed on the local file system — no content is uploaded to any third-party cloud servers.

🔗 View Source on GitHub