Sync to Obsidian for Openclaw

Automatically syncs AI coding sessions into structured Obsidian notes and visual Canvas maps with zero-config project detection.

chatrichai
v1.0.0
Mar 18, 2026
0
878
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install sync-obsidian

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 sync-obsidian 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 Sync to Obsidian?

Sync to Obsidian is a powerful integration designed to bridge the gap between active AI coding sessions and long-term knowledge management. By leveraging Openclaw Skills, this tool captures the intent, implementation details, and architectural decisions made during a Claude Code session and preserves them within your personal Obsidian vault. It eliminates manual copy-pasting by auto-detecting your project context and organizing data into logical folder structures.

The skill provides a unique dual-output system: a text-based Markdown report for deep reading and an interactive Obsidian Canvas for visual exploration. Whether you are drafting a new feature plan or documenting a complex implementation, this skill ensures your technical documentation stays synchronized with your actual development progress without adding administrative overhead.

Sync to Obsidian Use Cases

  • Archiving AI-generated implementation plans before starting code changes.
  • Generating automated post-session reports that document file modifications and design rationale.
  • Visualizing project architecture and task flows using the interactive Obsidian Canvas feature.
  • Maintaining a chronological history of developer-AI collaborations across multiple git repositories.
  • Streamlining handovers by providing clear, structured documentation of technical decisions made during a session.

How Sync to Obsidian Works

  1. The skill identifies the project name by checking the Git root directory or the current folder name.
  2. It ensures the necessary Obsidian vault directories (Project and Canvas folders) exist using recursive directory creation.
  3. For plans, it retrieves the latest plan from the session history or extracts the current context.
  4. For reports, it synthesizes a summary of completed work, file changes, and follow-up tasks.
  5. It transforms the technical data into a Markdown note using standardized templates.
  6. It simultaneously generates a JSON-based .canvas file, mapping the information into a visual layout with color-coded nodes.
  7. Both files are written to the Obsidian vault, and the local paths are returned to the user.

Sync to Obsidian Setup

To use this skill, ensure your Obsidian vault path is correctly configured within the skill settings. Replace the placeholder path with your actual vault location:

# Example configuration update
OBSIDIAN_VAULT = "/Users/yourname/Documents/Obsidian Vault"

To enable automated synchronization, you can add the sync triggers to your project's CLAUDE.md file, allowing Openclaw Skills to prompt for plan or report generation during key implementation milestones.

Sync to Obsidian Data Schema & Taxonomy

The skill organizes data within your Obsidian vault based on the auto-detected project name. It follows a predictable taxonomy for easy navigation:

Location File Type Naming Convention
/[Project] {name}/ Markdown [Type] {Title} (YYYY-MM-DD).md
/[Project] {name}/canvas/ Obsidian Canvas [Type] {Title} (YYYY-MM-DD).canvas

Metadata Structure: All notes use quote blocks (>) instead of YAML frontmatter to display Date, Source, Project, and Status, ensuring maximum compatibility with Obsidian's default preview.

Sync to Obsidian Advanced Features

  • Interactive Canvas Generation: Automatically creates visual maps with color-coded groups (e.g., cyan for summaries, purple for file changes).
  • Dual-Output Synchronicity: Every sync event generates both a text-based note and a visual diagram simultaneously.
  • Smart Content Sizing: Calculations for Canvas nodes prevent text clipping by dynamically adjusting card height based on line counts.
  • Zero-Config Detection: Uses Git integration to automatically determine project naming without manual user input.
  • CLAUDE.md Lifecycle Hooks: Supports automated triggers for 'Plan' syncs before execution and 'Report' syncs after implementation completion.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*