A comprehensive CLI tool to manage, automate, and AI-enrich Obsidian vaults via CouchDB and Obsidian LiveSync.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obsidian-curator
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-curator 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-curator?
obsidian-curator is a specialized utility designed for users who sync their Obsidian vaults using CouchDB via the Obsidian LiveSync plugin. Unlike tools that interact with the local filesystem, this skill interfaces directly with the database backend to perform maintenance and automation tasks. By integrating this into your set of Openclaw Skills, you can manage your personal knowledge base without needing the Obsidian application open.
The tool bridges the gap between raw data capture and a highly organized Knowledge Management system. It leverages AI adapters to handle the cognitive load of tagging, summarizing, and filing notes into structured systems like PARA, Zettelkasten, or Johnny Decimal, ensuring your second brain remains tidy and actionable.
obsidian-curator Use Cases
- Capturing quick thoughts or meeting notes directly from the command line for later processing.
- Using AI to automatically tag and categorize inbox items based on their content.
- Auditing vault structure to ensure all files comply with organizational presets like PARA or Zettelkasten.
- Managing and listing tasks across the entire vault without opening the Obsidian UI.
- Triage and cleanup of duplicate notes or empty stubs through automated logic.
How obsidian-curator Works
- Connects to a user-configured CouchDB instance that hosts the Obsidian LiveSync database.
- Scans the designated 'inbox' for new or unprocessed markdown documents.
- Utilizes AI (Ollama, OpenAI, or Anthropic) to analyze note content and suggest metadata and folder paths.
- Updates document records directly in CouchDB to move or tag files based on confidence scores.
- Executes structural checks to identify dead links, duplicates, or vault organization violations.
obsidian-curator Setup
To integrate this tool with your other Openclaw Skills, install the package via npm and run the interactive initialization wizard:
npm install -g obsidian-curator
obsidian-curator init
During setup, you will provide your CouchDB connection details (host, port, credentials) and choose your preferred AI provider and vault structure preset. Ensure that Obsidian LiveSync has E2EE disabled to allow the tool to read and write document content.
obsidian-curator Data Schema & Taxonomy
The skill interacts with the CouchDB document store and local configuration files to manage your vault data:
| Component | Description |
|---|---|
| CouchDB Docs | Markdown content and metadata stored as JSON objects in the sync database. |
| Frontmatter | YAML metadata updated by the skill, including tags, aliases, and summary fields. |
| config.json | Local configuration stored in ~/.obsidian-curator/ defining AI keys and vault presets. |
| Tasks | Markdown task syntax (- [ ]) parsed and managed through the CLI interface. |
obsidian-curator Advanced Features
- Multi-agent AI support allowing for local processing with Ollama or cloud power with Anthropic and OpenAI.
- Programmatic Node.js API for developers to build custom automation scripts on top of Openclaw Skills.
- Support for multiple organizational presets including PARA, Zettelkasten, and Johnny Decimal.
- Secure build provenance with Sigstore attestation and zero lifecycle scripts for maximum security.
- Dry-run capabilities for all filing and tidying operations to prevent data loss.
SKILL.md
Loading
Related Openclaw Skills
Muninn Memory
A local-first memory system for AI agents that provides semantic search, entity extraction, and intelligent recall.
Crunch Protocol CLI Skill
A natural language interface for the Crunch Protocol CLI that simplifies managing decentralized AI competitions and coordinator configurations.
Crunch Protocol CLI Skill
A natural language interface for the Crunch Protocol CLI that simplifies the management of decentralized AI competitions, rewards, and coordinators.
Cruncher Competition Manager
A specialized tool for managing the entire lifecycle of CrunchDAO data science competitions, from workspace setup to final submission.
Zight
Extracts structured metadata, AI summaries, and full text transcripts from Zight share links for automated reasoning.
Moltopia AI Agent Skill
A comprehensive skill enabling AI agents to live, craft, trade, and socialize within the Moltopia virtual world.
Featured*
