obsidian

The Obsidian skill for OpenClaw provides a powerful command-line interface for interacting with local Obsidian vaults. Designed for power users and developers, this skill enables programmatic access to your personal knowledge management system. By leveraging the obsidian-cli, users can integrate their notes into automated workflows, allowing the AI to query information, maintain vault structure, or generate content directly within the local file system without needing to open the GUI. It is ideal for users who rely on plain-text Markdown workflows and want to extend their productivity through automation. The skill interacts directly with the vault files—consisting of .md files, .canvas JSON files, and attachment directories—ensuring full compatibility with the standard Obsidian desktop application while maintaining the integrity of workspace settings. By providing a bridge between the OpenClaw AI assistant and your local notes, it transforms your vault into a dynamic, queryable database that responds to natural language commands and scriptable triggers.

• Perform granular searches for note titles or full-text content within the vault, receiving snippets and line numbers for quick context.

• Automate note creation with specific content, utilizing Obsidian URI handlers for seamless integration with the desktop environment.

• Execute safe file refactoring, including moving or renaming notes with automatic updates to internal [[wikilinks]] and standard Markdown references across the vault.

• Support for multiple vault management, allowing users to switch between different workspaces like personal, work, or iCloud-synced folders via automated configuration detection.

• Direct deletion and cleanup capabilities, providing a reliable way to prune or organize your knowledge base programmatically.

• Always ensure Obsidian is installed and the URI handler is configured for features that trigger GUI-specific actions like opening a note.

• Use the set-default command to designate a primary vault, preventing the need for hardcoded paths in your automation scripts.

• For bulk operations or complex refactoring, it is recommended to verify the vault structure periodically, as the skill adheres to standard Markdown and folder-based storage.

• Avoid manual modification of the .obsidian hidden configuration folder via scripts to prevent corruption of workspace and plugin settings.

• Ideal for integrating Obsidian into broader AI-driven pipelines, such as automatically logging agent outputs or summarizing daily activities into specific project folders.