A Git-powered synchronization engine to keep your AI agent workspace consistent across local machines and remote servers.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install claw-roam
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 claw-roam 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 Claw Roam?
Claw Roam is a specialized utility designed to bridge the gap between multiple development and runtime environments. By leveraging Git as a transport layer, it ensures that your agent core identity—including its soul, long-term memory, and custom configurations—remains consistent whether you are working on a local Mac or a remote VPS. This is one of the most powerful Openclaw Skills for developers who need mobility without losing the context of their AI interactions.
The skill eliminates the friction of manual file transfers by providing a structured workflow for committing, pushing, and pulling workspace state. Whether you are migrating to a new machine or maintaining a continuous agent personality across travel, Claw Roam provides the reliability of version control to your agentic workflows.
Claw Roam Use Cases
- Syncing workspace changes from a local Mac to a remote VPS before traveling or shutting down.
- Migrating an existing OpenClaw setup and its associated personality to a new machine or server.
- Maintaining a centralized, versioned backup of agent memories and daily conversation logs via Git.
- Checking synchronization status between different devices to prevent data divergence and ensure memory continuity.
How Claw Roam Works
- The user initializes a Git repository within the OpenClaw workspace directory and connects it to a private remote repository.
- When changes are made to the agent personality or memory, the push command stage and commits all updates with a timestamped message.
- On a secondary machine, the pull command fetches the latest remote changes and applies them to the local workspace.
- For multi-device setups, a branching strategy (main, local, remote) is used to isolate machine-specific changes before merging them into a shared baseline.
- The sync command automates the entire lifecycle, handling commits, merges, and pushes in a single operation to keep Openclaw Skills up to date everywhere.
Claw Roam Setup
- Initialize the Git repository in your workspace directory:
cd ~/.openclaw/workspace
git init
git remote add origin <your-repo-url>
- Create the initial baseline commit:
git add -A
git commit -m "initial"
git push -u origin main
- On your secondary machine (e.g., a VPS), clone the repository and link it:
cd ~
git clone <your-repo-url> openclaw-workspace
ln -s openclaw-workspace ~/.openclaw/workspace
Claw Roam Data Schema & Taxonomy
Claw Roam tracks critical workspace files while ignoring transient runtime data:
| File/Folder | Purpose | Synced |
|---|---|---|
SOUL.md |
Core agent personality and instructions | Yes |
MEMORY.md |
Long-term distilled memory | Yes |
memory/*.md |
Historical conversation logs | Yes |
skills/ |
Custom and installed Openclaw Skills | Yes |
TOOLS.md |
Device and tool configurations | Yes |
*.db |
Local SQLite session databases | No |
HEARTBEAT.md |
Scheduled task configurations | Yes |
Claw Roam Advanced Features
- Multi-branch synchronization strategy (local/remote/main) for complex multi-device environments.
- Automated synchronization capabilities via crontab for continuous, hands-free background backups.
- Integrated gateway lifecycle management that automatically restarts the OpenClaw gateway when changes are pulled on a VPS.
- Conflict resolution workflow helpers to manage divergent agent memories and prevent data loss during merges.
SKILL.md
Loading
Related Openclaw Skills
Bitfinex Lending Monitor
Automate the monitoring and reporting of Bitfinex funding interest and wallet balances through secure API integration.
Agent Dashboard Sync
A high-performance, no-LLM synchronization pipeline to monitor AI agent heartbeats and runtime status via Cloudflare KV and Worker APIs.
Polymarket FastLoop Trader
A high-frequency trading agent that automates Polymarket sprint market positions using real-time price signals from centralized exchanges.
CamoFox MCP for OpenClaw
A production-ready anti-detection browser automation toolkit providing 41 specialized tools for Openclaw Skills agents.
DB Read-Only Skill
A secure interface for executing read-only SQL queries against PostgreSQL and MySQL databases without risk of data modification.
Knowledge Base Collector
A versatile tool for archiving URLs and screenshots into a tag-first, searchable personal knowledge base.
Featured*
