Obsidian for Openclaw

A comprehensive automation skill for managing Obsidian vaults and Markdown notes directly through the command line.

bassshang
v1.0.0
Mar 13, 2026
3
3.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install obsidian-notesmd-cli

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install obsidian-notesmd-cli 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?

The Obsidian skill provides a powerful interface for AI agents to interact with local knowledge bases. Since Obsidian vaults are essentially collections of plain Markdown files, this skill leverages notesmd-cli to bridge the gap between structured note-taking and programmatic automation. It allows users to manipulate files, manage metadata, and refactor links without needing the Obsidian desktop application to be active.

By integrating this tool into your Openclaw Skills library, you can automate the lifecycle of your personal knowledge management (PKM) system. Whether you are generating technical documentation or organizing research, this skill ensures that your AI agents can read, write, and organize notes according to your existing Obsidian configurations, including daily note templates and file exclusion rules.

Obsidian Use Cases

  • Creating daily notes automatically from meeting transcripts or task summaries.
  • Searching through technical vaults to find specific snippets or research data.
  • Batch editing YAML frontmatter to update project statuses across multiple notes.
  • Refactoring vault organization by moving files while maintaining internal wikilink integrity.
  • Programmatically generating new notes from templates during development workflows.

How Obsidian Works

  1. The skill detects active Obsidian vaults by analyzing the obsidian.json configuration file located in the application support directory.
  2. It utilizes notesmd-cli as the primary execution engine to perform file system operations on Markdown files.
  3. Users define a default vault and interaction behavior, such as opening notes in a terminal editor or the Obsidian app.
  4. The skill executes search queries, respecting the vault's specific ignore patterns and configuration settings.
  5. Link refactoring is handled automatically during move operations, ensuring that all internal references within the Openclaw Skills environment remain functional.

Obsidian Setup

To get started with these Openclaw Skills, you must first install the notesmd-cli utility using Homebrew:

brew tap yakitrak/yakitrak
brew install notesmd-cli

After installation, set your default vault to enable seamless automation:

notesmd-cli set-default "<your-vault-folder-name>"
notesmd-cli set-default --open-type editor

Obsidian Data Schema & Taxonomy

Component Description Data Format
Vault Path The root directory of the knowledge base Folder Path
Note Files Plain text Markdown content .md
Frontmatter Metadata for categorization and tracking YAML
Canvas Visual layout and relationship maps JSON
Daily Notes Chronological logs based on templates .md
Config Workspace and plugin settings .obsidian/

Obsidian Advanced Features

  • Headless operation allowing full vault management without the Obsidian GUI.
  • Interactive fuzzy search and deep content querying with context snippets.
  • Automatic wikilink and Markdown link resolution during file renaming or relocation.
  • Native support for Obsidian daily note configurations, including custom date formats and folder paths.
  • YAML frontmatter manipulation for high-speed metadata editing across the vault via Openclaw Skills commands.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*