A macOS utility that leverages iCloud Drive to synchronize OpenClaw configurations, agents, and workspace templates across multiple devices using symbolic links.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obsidian-openclaw-sync
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install obsidian-openclaw-sync 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 OpenClaw Sync?
Obsidian OpenClaw Sync is a purpose-built utility designed for developers who need their AI agent environments to be portable and consistent. By utilizing the native iCloud Drive integration of Obsidian, this tool automates the management of symbolic links between your local machine and the cloud. This ensures that your entire collection of Openclaw Skills, project files, and agent definitions are always up to date, regardless of which Mac you are currently using.
The skill addresses the common pain point of manual configuration mirroring. It allows users to maintain a single source of truth within an Obsidian vault while benefiting from the performance of local file access. Whether you are managing complex multi-agent workflows or simple automation scripts, this tool provides the infrastructure necessary for a unified development experience across the ecosystem of Openclaw Skills.
Obsidian OpenClaw Sync Use Cases
- Synchronizing AI agent configurations between a primary iMac and a mobile MacBook.
- Maintaining a consistent library of Openclaw Skills across different Obsidian vaults.
- Sharing workspace templates and project media files through a central iCloud repository.
- Rapidly onboarding new macOS hardware by linking to existing cloud-based agent settings.
- Managing multiple AI agent personalities and their associated data schemas in a unified sync flow.
How Obsidian OpenClaw Sync Works
- The utility scans the local macOS system to locate the specific iCloud Drive folder used by Obsidian.
- It identifies valid vaults that contain existing OpenClaw configurations or potential agent structures.
- Through the setup command, the tool creates symlinks from the local .openclaw directory to the corresponding folders in the iCloud vault.
- It maps critical directories such as skills, projects, and media to ensure all assets are included in the sync.
- When changes are made to your Openclaw Skills on one device, macOS background processes sync the files to iCloud, which then updates all other linked devices automatically.
Obsidian OpenClaw Sync Setup
Prerequisites
- macOS with iCloud Drive enabled.
- Python 3.x installed.
- Obsidian installed with at least one vault synced via iCloud.
Installation & Configuration
# Verify your environment
python3 --version
ls -ld ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents
# Check current sync status of your Openclaw Skills
/obsidian-openclaw-sync status
# Run the interactive setup to link your local config to iCloud
/obsidian-openclaw-sync setup
# On secondary devices, use the overwrite flag to replace local configs
/obsidian-openclaw-sync setup --overwrite --no-confirm
Obsidian OpenClaw Sync Data Schema & Taxonomy
The skill organizes data by mapping local paths to the iCloud Obsidian vault structure as follows:
| Source (iCloud) | Target (Local) | Content Type |
|---|---|---|
skills/ |
./skills/ |
Custom Openclaw Skills and logic |
projects/ |
./projects/ |
Agent-specific project data |
media/ |
./media/ |
Images, videos, and assets |
workspace-*/ |
./workspace-*/ |
Multi-agent templates |
openclaw.json |
./openclaw.json |
Main configuration (with --overwrite) |
.openclaw/*.json |
./.openclaw/*.json |
Internal agent metadata |
Obsidian OpenClaw Sync Advanced Features
- Multi-agent workspace support: Automatically detects and links template directories using wildcard matching for workspace configurations.
- Overwrite Control: Safeguards local configurations by requiring an explicit flag to replace the primary openclaw.json with an iCloud symlink.
- Automated Conflict Resolution: Provides a status command to identify broken symlinks or missing configuration files across the Openclaw Skills environment.
- Headless Setup: Supports flags like --no-confirm and --vault index for automated environment provisioning scripts.
SKILL.md
Loading
Related Openclaw Skills
Keepa API Client
A comprehensive CLI-based Amazon product tracking tool that leverages the Keepa API for price history and market analysis.
Feishu Calendar Advanced
A powerful CLI-driven skill for managing Feishu (Lark) calendars with advanced features like event creation and conflict detection.
Feishu Agent
A versatile CLI tool for AI assistants to manage Feishu calendars, Bitable tasks, and organizational contacts.
Lark & Feishu Integration
A robust webhook bridge that connects Lark or Feishu messaging platforms to OpenClaw for intelligent, bidirectional AI communication.
obsidian-task
A specialized CLI integration for managing, toggling, and creating tasks directly within your Obsidian vault.
Product Image Generator
A sophisticated AI agent skill for creating platform-optimized, professional product photography and marketing visuals.
METADATA
Featured*
