obsidian-openclaw-sync

What This Skill Does

The obsidian-openclaw-sync skill is a robust utility designed to bridge the gap between local OpenClaw workspace configurations and remote storage managed via Obsidian's iCloud Drive integration. By automating the creation of symlinks, it ensures that your agent workspaces, active skill configurations, and project media are identical across every Apple device you own. Instead of manually copying files or managing disparate configurations, this skill treats your iCloud-based Obsidian vault as the 'source of truth' for all OpenClaw operations, making your AI agent environment truly mobile and synchronized.

Installation

To integrate this into your agent environment, execute the following command via the terminal or within your OpenClaw interface: clawhub install openclaw/skills/skills/boyd4y/obsidian-openclaw-sync Ensure you have python3 installed and that your Obsidian vaults are correctly set to sync with iCloud Drive before running the installation, as the tool relies on the standard macOS iCloud directory structure (/Library/Mobile Documents/iCloudmd~obsidian/Documents).

Use Cases

This skill is perfect for power users who leverage OpenClaw on both their primary workstation and their MacBook while traveling. Use it to keep your multi-agent workspace templates consistent, ensuring that when you refine an agent prompt or update a skill on your desktop, those changes appear automatically on your laptop. It is also invaluable for users who store heavy project media in Obsidian and want to access those assets seamlessly through their agent workflows without duplicating data locally.

Example Prompts

1. "OpenClaw, please run the obsidian-openclaw-sync status command to verify my iCloud vaults are correctly linked."
2. "I need to setup sync for my 'Research' vault; please run the setup command with the --overwrite flag to ensure my local configuration matches the cloud."
3. "Run the obsidian-openclaw-sync unset command, I need to remove the symlinks from my current local directory."

Tips & Limitations

This tool is exclusively compatible with macOS because it leverages the specific pathing of the iCloud Drive sync daemon. Always ensure your iCloud drive has finished syncing a vault before initiating the setup command to prevent file conflicts. When using the --overwrite flag, proceed with caution, as it will replace your existing local openclaw.json file with the version found in your iCloud vault. If you have unique local-only overrides that should not be touched, omit the --overwrite flag to maintain local file integrity.