clawroam

What This Skill Does

ClawRoam functions as a portable, encrypted identity vault for OpenClaw agents. By maintaining a synchronized, versioned state across disparate machines, it ensures that your agent’s knowledge, project memory, system packages, and skill configuration remain consistent regardless of where you are working. Think of it as a cross-platform synchronization layer—similar to iCloud for your AI agent—that utilizes an Ed25519-based encryption model to ensure that private keys and sensitive configurations never leave your local environment. It supports a diverse range of storage providers, including managed cloud options and your own existing infrastructure (S3, Git, WebDAV, etc.), providing flexibility and total ownership over your data.

Installation

To integrate this skill into your environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/getlighty/getlighty-clawroam Once installed, you must initialize the vault by running clawroam.sh init. This process establishes your local directory structure, generates your unique Ed25519 keypair, and conducts an initial scan of your system packages. Finally, choose your preferred storage provider using the configuration commands provided in the 'First-Time Setup' section of the documentation.

Use Cases

ClawRoam is essential for power users and developers who move between multiple workstations throughout the day. It allows you to maintain a consistent 'brain' across a laptop, a desktop, and a cloud-based server environment without manually transferring context files. It is also a powerful backup solution; because every state change is committed as a versioned delta, you can rollback your agent’s configuration to a previous state if an update causes unexpected behavior or memory corruption.

Example Prompts

1. "Set up clawroam using Google Drive as my primary storage provider."
2. "Show me the vault status; has my recent project memory sync completed yet?"
3. "I think I made a mistake with my configuration; please roll back the vault to the last stable version."

Tips & Limitations

• Security First: While ClawRoam supports various BYOS (Bring Your Own Storage) options, always ensure your chosen remote bucket or server is properly secured with strong credentials.
• Scope Awareness: Remember that the local/SOUL.md and local/IDENTITY.md files are deliberately excluded from synchronization to maintain unique agent personalities on different hardware. If you require a unified persona, you must manage these locally.
• Performance: While the sync is generally invisible and automatic, large binary files in your project directories may impact sync latency on slow connections. Use the sync-engine.sh log command regularly to monitor the health of your commit history.