| name | clawroam |
| description | Portable identity vault for OpenClaw. Syncs knowledge, packages, and memory across machines like iCloud — automatic, invisible, encrypted. Bring your own storage (Google Drive, Dropbox, FTP, Git) or use ClawRoam Cloud.
|
| version | 3.0.1 |
| author | getlighty |
| license | MIT |
| tags | ["sync","identity","migration","packages","backup","roaming"] |
| triggers | ["vault","sync","migrate","packages","roam","backup","restore","cloud"] |
| tools | ["exec","file","network"] |
| requires | ["curl","git","openssl","ssh-keygen","python3","rsync","tar","fswatch","bc"] |
| network | [{"url":"https://clawroam-api.ovisoftblue.workers.dev","description":"ClawRoam Cloud managed storage backend (Cloudflare Workers + D1 + R2). Only contacted when the built-in 'cloud' provider is selected. Not used for BYOS providers (gdrive, dropbox, git, ftp, s3, local, webdav).\n","data_sent":["email address (signup only)","Ed25519 public key (signup and key rotation)","encrypted vault archive (AES-256-CBC; server cannot decrypt)","file path manifest (filenames and sizes only, not file content)"],"data_stored_server_side":"Encrypted vault snapshots (up to 10 versions per profile), public keys, email address. Private key never leaves the local machine.\n"}] |
ClawRoam — Portable Agent Environment
You are an OpenClaw agent with the clawroam skill installed. This skill
gives you automatic, continuous sync of the user's knowledge and environment
across all their machines — like iCloud for AI agents.
Architecture
ClawRoam works like a combination of iCloud and Git:
- Auto-sync: file changes are detected, auto-committed, and pushed
- Versioned: every change is a commit — full history, rollback anytime
- Encrypted: Ed25519 keypair per installation — private key never leaves the machine
- Multi-provider: user picks where their vault lives
Providers
| Provider | Type | Setup |
|---|
| ClawRoam Cloud | Managed (paid per MB) | One command — clawroam cloud signup |
| Google Drive | BYOS (free) | OAuth flow via clawroam provider gdrive |
| Dropbox | BYOS (free) | OAuth flow via clawroam provider dropbox |
| FTP/SFTP | BYOS (free) | Host + credentials via clawroam provider ftp |
| Git | BYOS (free) | Any git remote via clawroam provider git |
| S3 | BYOS (free) | Any S3-compatible via clawroam provider s3 |
| WebDAV | BYOS (free) | Nextcloud etc via clawroam provider webdav |
| Local | BYOS (free) | USB/NAS mount via clawroam provider local |
"BYOS" = Bring Your Own Storage. Free forever. ClawRoam Cloud is the
convenience option for people who don't want to manage storage.
What Syncs
ALWAYS SYNCED (shared knowledge pool):
identity/USER.md Who you are
knowledge/MEMORY.md Long-term memory
knowledge/projects/ Project context
requirements.yaml System packages
skills-manifest.yaml Installed skills list
NEVER AUTO-SYNCED (per-instance):
local/SOUL.md This agent's personality
local/IDENTITY.md This agent's identity
local/config-override Local config tweaks
OPT-IN SYNC:
openclaw config.json Gateway/model config
credentials/ Channel auth (encrypted separately)
