claw-roam

What This Skill Does

Claw Roam is a specialized synchronization agent designed for power users of OpenClaw who operate across multiple environments, such as a local macOS machine and a remote VPS. At its core, the skill manages your OpenClaw workspace—including personality configurations, accumulated memories, and custom skill sets—by wrapping complex Git operations into a simple, automated command-line interface. By establishing a robust synchronization pipeline, it ensures that your AI assistant remains consistent, regardless of the machine you are currently logged into.

Installation

To begin, ensure your OpenClaw workspace is initialized as a Git repository. Navigate to your workspace directory (~/.openclaw/workspace), run git init, and add your remote repository using git remote add origin <url>. Once the foundation is set, install the skill directly via the terminal:

clawhub install openclaw/skills/skills/ryanhong666/claw-roam

Use Cases

1. Seamless Machine Migration: Effortlessly transition your AI's personality and memory from your laptop to a cloud environment when you need to run background tasks 24/7.
2. State Backups: Automatically save your workspace state to a secure remote Git repository, acting as a version-controlled backup system.
3. Collaborative Development: Use the branching model (local, remote, main) to experiment with new skill configurations on one machine without affecting the production environment on another.

Example Prompts

• "Claw, please sync my current workspace to the remote repository so I can pick up where I left off on my VPS."
• "Run a check on my sync status; I need to make sure my local changes from this morning are safely pushed."
• "I'm switching machines now, can you perform a full pull of the latest workspace updates?"

Tips & Limitations

• Branching Discipline: Stick to the recommended main, local, and remote branch architecture to avoid complex merge conflicts.
• Shutdown Routine: Always run claw-roam sync before turning off your machine to ensure your most recent memory updates are committed.
• Limitations: This tool relies on Git; ensure your Git credentials are saved via SSH keys or a credential manager to prevent interruption during the automated sync process. It is intended for text-based workspace configurations and may not be optimized for large binary file synchronization.