Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Claw Roam syncs an OpenClaw workspace across multiple machines using Git. It tracks personality files, long-term memory, and installed skills so they stay consistent between a local Mac and a remote VPS. Commands cover pushing changes, pulling updates, checking sync status, and running a full merge-and-share cycle in one step.
It uses a Git branching model built for multi-device OpenClaw setups, so switching machines requires one command instead of manual file transfers or reconfiguration.
When to use it
- Push workspace changes before shutting down a local Mac
- Pull the latest workspace onto a VPS before working remotely
- Check sync status between two machines before switching
- Migrate OpenClaw personality and memory to a new device
- Auto-sync workspace on a schedule using cron
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: sync my workspace before I switch to my VPS
- 1Run `claw-roam push 'end of day'` on local Mac to commit and push all workspace changes
- 2SSH into the remote VPS
- 3Run `claw-roam pull` to fetch the latest workspace from the Git remote
- 4OpenClaw gateway restarts automatically on the VPS to apply the updated files
VPS workspace matches the local Mac state, with the same personality, memory, and skills available
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.