How do I install the Obsidian Openclaw Sync skill?

Run npx skillmds@latest add dvcrn/obsidian-openclaw-sync in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian Openclaw Sync safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian Openclaw Sync?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian Openclaw Sync free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Obsidian Openclaw Sync?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian Openclaw Sync by dvcrn — Agent Skill

Name: Obsidian Openclaw Sync
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Obsidian OpenClaw Sync

Helper tool for syncing OpenClaw configuration between iCloud Drive and local Obsidian vaults.

Purpose

This skill solves the problem of syncing OpenClaw configuration across multiple devices via iCloud:

Automatically detects all iCloud vaults with OpenClaw configs
Creates symlinks from local to iCloud for seamless sync
Supports multi-agent workspace templates (workspace_*, workspace-*)
Manages openclaw.json sync with overwrite control

Dependencies

Dependency	Required	Description
`python3`	Yes	Python 3.x (macOS comes with Python pre-installed)
`macOS`	Yes	This skill only works on macOS (iCloud Drive integration)
`obsidian-icloud-sync`	Yes	Obsidian must be set up to sync vaults via iCloud Drive

Check Dependencies

# Check Python availability
python3 --version

# Check iCloud Obsidian path exists
ls -ld ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents

Usage

/obsidian-openclaw-sync [command] [options]

Commands

Command	Description
`status`	Show all iCloud vaults with agents and skills, indicates sync status
`setup`	Interactive setup to sync a vault to local
`unset`	List and remove local symlinks

Options

Option	Short	Description
`--vault N`	`-v N`	Pre-select vault by index (default: interactive)
`--overwrite`	`-w`	Overwrite local `openclaw.json` with symlink to iCloud version
`--no-confirm`	`-y`	Skip confirmation prompt (auto-confirm)

Examples

# Check sync status (shows all iCloud vaults)
/obsidian-openclaw-sync

# Interactive setup (select vault, create symlinks)
/obsidian-openclaw-sync setup

# Setup with overwrite (replace local openclaw.json with iCloud symlink)
/obsidian-openclaw-sync setup --overwrite

# Setup without confirmation prompt (auto-confirm)
/obsidian-openclaw-sync setup --no-confirm

# Setup specific vault without prompts
/obsidian-openclaw-sync setup --vault 1 --no-confirm

# List and remove local symlinks
/obsidian-openclaw-sync unset

Output Format

✓ iCloud Obsidian: /Users/.../iCloud~md~obsidian/Documents

✓ Valid Vaults (N):
  ✓ <vault-name>
      Agents (N): <agent1>, <agent2>, ...
      Skills (N): <skill1>, <skill2>, ...
  ○ <vault-name> [openclaw.json not found (recommended)]

✗ Invalid Vaults (N):
  ✗ <vault-name> (missing: .obsidian/)

Local Config: .openclaw
  Agents (N): <agent1>, <agent2>, ...
  Skills (N): <skill1>, <skill2>, ...

Synced Directories

Source (iCloud)	Target (Local)
`media/`	`./media/`
`projects/`	`./projects/`
`team/`	`./team/`
`skills/`	`./skills/`
`workspace-*/`	`./workspace-*/`
`.openclaw/*.json`	`./.openclaw/*.json`
`openclaw.json`	`./openclaw.json` (with --overwrite)

Multi-Device Sync Flow

Device 1: Run setup to create symlinks to iCloud vault
Device 2: Run setup --overwrite to replace local config with iCloud symlink
All devices: Changes sync via iCloud Drive automatically

References

Sync Helper Script - Core Python script for vault detection

---name: obsidian-openclaw-syncdescription: Sync Obsidian OpenClaw config across multiple iCloud devices. Manages symlinks for seamless multi-device sync.---# Obsidian OpenClaw SyncHelper tool for syncing OpenClaw configuration between iCloud Drive and local Obsidian vaults.## PurposeThis skill solves the problem of **syncing OpenClaw configuration across multiple devices via iCloud**:- Automatically detects all iCloud vaults with OpenClaw configs- Creates symlinks from local to iCloud for seamless sync- Supports multi-agent workspace templates (workspace_*, workspace-*)- Manages `openclaw.json` sync with overwrite control## Dependencies| Dependency | Required | Description ||------------|----------|-------------|| `python3` | Yes | Python 3.x (macOS comes with Python pre-installed) || `macOS` | Yes | This skill only works on macOS (iCloud Drive integration) || `obsidian-icloud-sync` | Yes | Obsidian must be set up to sync vaults via iCloud Drive |### Check Dependencies```bash# Check Python availabilitypython3 --version# Check iCloud Obsidian path existsls -ld ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents```## Usage```bash/obsidian-openclaw-sync [command] [options]```## Commands| Command | Description ||---------|-------------|| `status` | Show all iCloud vaults with agents and skills, indicates sync status || `setup` | Interactive setup to sync a vault to local || `unset` | List and remove local symlinks |## Options| Option | Short | Description ||--------|-------|-------------|| `--vault N` | `-v N` | Pre-select vault by index (default: interactive) || `--overwrite` | `-w` | Overwrite local `openclaw.json` with symlink to iCloud version || `--no-confirm` | `-y` | Skip confirmation prompt (auto-confirm) |## Examples```bash# Check sync status (shows all iCloud vaults)/obsidian-openclaw-sync# Interactive setup (select vault, create symlinks)/obsidian-openclaw-sync setup# Setup with overwrite (replace local openclaw.json with iCloud symlink)/obsidian-openclaw-sync setup --overwrite# Setup without confirmation prompt (auto-confirm)/obsidian-openclaw-sync setup --no-confirm# Setup specific vault without prompts/obsidian-openclaw-sync setup --vault 1 --no-confirm# List and remove local symlinks/obsidian-openclaw-sync unset```## Output Format```✓ iCloud Obsidian: /Users/.../iCloud~md~obsidian/Documents✓ Valid Vaults (N): ✓ <vault-name> Agents (N): <agent1>, <agent2>, ... Skills (N): <skill1>, <skill2>, ... ○ <vault-name> [openclaw.json not found (recommended)]✗ Invalid Vaults (N): ✗ <vault-name> (missing: .obsidian/)Local Config: .openclaw Agents (N): <agent1>, <agent2>, ... Skills (N): <skill1>, <skill2>, ...```## Synced Directories| Source (iCloud) | Target (Local) ||-----------------|----------------|| `media/` | `./media/` || `projects/` | `./projects/` || `team/` | `./team/` || `skills/` | `./skills/` || `workspace-*/` | `./workspace-*/` || `.openclaw/*.json` | `./.openclaw/*.json` || `openclaw.json` | `./openclaw.json` (with --overwrite) |## Multi-Device Sync Flow1. **Device 1**: Run `setup` to create symlinks to iCloud vault2. **Device 2**: Run `setup --overwrite` to replace local config with iCloud symlink3. **All devices**: Changes sync via iCloud Drive automatically## References- [Sync Helper Script](scripts/sync_helper.py) - Core Python script for vault detection

Frequently asked questions

Obsidian Openclaw Sync