obsidian

What This Skill Does

The obsidian skill enables your OpenClaw agent to interact directly with your Obsidian vaults. Unlike generic file system tools, this skill leverages obsidian-cli to handle the specific complexities of Markdown note-taking. It allows the agent to search for notes by title or content, create new entries, and perform safe move/rename operations that automatically update internal [[wikilinks]]. By reading the Obsidian configuration files, the agent understands your vault structure without requiring you to hardcode file paths, ensuring seamless automation across multiple vaults.

Installation

To integrate this skill into your environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/12357851/obsidian-1-0-0-local-backup

Ensure you have Obsidian installed on your machine and the obsidian-cli utility correctly configured in your system path, as the agent relies on this bridge to execute commands.

Use Cases

• Knowledge Management: Organize your digital brain by having the agent search, consolidate, or rename notes based on broad project themes.
• Daily Workflow Automation: Automatically create daily meeting notes or task lists in specific project folders using templates or content generated by the agent.
• Refactoring: Safely move large collections of notes while the agent preserves your backlink integrity, preventing broken links that typically occur with standard file system mv commands.
• Content Retrieval: Quickly pull information from deep within your archives using content-aware searches rather than relying on exact file names.

Example Prompts

1. "Search for my notes about 'Project Alpha' and summarize the key action items listed in the meeting notes."
2. "Create a new note in the 'Personal/Journal' folder titled 'Ideas-2023-10-27' with the content: 'Brainstormed new workflows for the automation pipeline.'"
3. "Move the note 'Old-Project-Draft' to the 'Archive/2022' folder and make sure all linked references are updated correctly."

Tips & Limitations

• Direct Edits: Since vaults are just folders, don't be afraid to edit files manually in your text editor. Obsidian is robust and will reflect changes automatically. Only use the skill when you need complex link updates or agent-driven organization.
• Vault Configuration: Always use obsidian-cli set-default to point the agent to your primary vault. This avoids ambiguity if you manage multiple vaults for work and personal life.
• URI Constraints: Avoid using the agent to create files in hidden system folders (starting with a dot), as the Obsidian URI handler may block such requests for safety reasons.
• Permission: Ensure your agent has proper read/write access to your document directories to prevent execution errors.