obsidian-openclaw-sync_skill

Overview

This skill syncs Obsidian OpenClaw configuration across multiple macOS devices using iCloud Drive. It detects iCloud vaults with OpenClaw configs and creates local symlinks so agents, skills, assets, and workspace templates stay consistent across devices. It also optionally manages openclaw.json with controlled overwrite behavior.

How this skill works

The tool scans the iCloud Obsidian Documents folder for valid vaults and inspects each for OpenClaw structure (agents, skills, .openclaw, workspace_* templates). It then creates or removes symlinks from local vault paths to the iCloud source for directories like assets/, projects/, team/, skills/, and workspace-*/. An overwrite option replaces the local openclaw.json with a symlink to the iCloud copy to centralize config.

When to use it

• You maintain Obsidian vaults across multiple macOS devices via iCloud Drive.
• You want a single source of truth for OpenClaw agents, skills, and shared assets.
• You need consistent multi-agent workspace templates synchronized across devices.
• You prefer symlink-based sync instead of manual file copying or separate sync tools.
• You want automated detection of valid iCloud vaults and quick setup/removal of links.

Best practices

• Run the status command first to confirm iCloud vault detection and which vaults contain OpenClaw configs.
• Use setup on the first device without overwrite to create symlinks to iCloud sources, then use setup --overwrite on other devices to point local configs to iCloud.
• Back up your local openclaw.json before using --overwrite if you have unique local settings to preserve.
• Keep Obsidian configured to sync via iCloud Drive and confirm the iCloud Obsidian path exists before running the tool.
• Use --no-confirm for scripted or CI-driven setups, but avoid it for first-time runs to prevent accidental replacements.

Example use cases

• Set up a new Mac: run setup to link the local vault to the team iCloud vault and sync agents and skills.
• Move to a second device: run setup --overwrite to ensure openclaw.json uses the iCloud canonical version.
• Audit vaults: run status to see which iCloud vaults are valid, missing openclaw.json, or have missing .obsidian folders.
• Clean up links: run unset to list and remove local symlinks when decommissioning a device or vault.
• Automate onboarding: run setup --vault N --no-confirm from a script to quickly configure a specific vault.