Official Verified

clawroam

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.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/getlighty/clawroam

Download Source Code (.zip)

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)

Commands

When the user asks about vault operations, use these:

First-Time Setup

"set up clawroam" → clawroam.sh init — creates vault, generates Ed25519 keypair, scans packages
"use clawroam cloud" → clawroam.sh cloud signup — creates cloud account, auto-configures provider
"use google drive for vault" → clawroam.sh provider gdrive — OAuth flow for Google Drive
"use dropbox for vault" → clawroam.sh provider dropbox
"use FTP for vault" → clawroam.sh provider ftp — asks for host, port, credentials

Daily Use (mostly invisible)

"sync status" → clawroam.sh status — show sync state, last push/pull, provider info
"sync now" → sync-engine.sh push — force immediate sync
"show vault history" → sync-engine.sh log — show commit history (like git log)
"rollback vault" → sync-engine.sh rollback — revert to previous state
"what changed" → sync-engine.sh diff — show pending changes

Read Full Documentation on GitHub

Metadata

Author@getlighty

Stars2387

Updated2026-03-09

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-getlighty-clawroam": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Related Skills

clawvault

getlighty 2387

nihao

Nostr identity setup and health-check CLI. Creates a complete Nostr identity (keypair, profile, relay list, lightning address, Cashu wallet) in one command. Audits existing npub health with a 0–8 score. Single Go binary, non-interactive, agent-friendly.

dergigi 2387

clawsync