ClawClone

Backup, clone, store, and migrate your OpenClaw workspace configurations.

Install

If the environment does not have the clawclone skill, use clawhub install clawclone to install it.

What Gets Backed Up

Backup Location: ~/.openclaw/backup

Dependencies

Requires: node (v16+), tar, npm (all standard on OpenClaw instances).

Check: which node tar npm

Prerequisites

Before using cloud features, verify the environment variable is set:

# Check if CLAWCLONE_API_KEY is set
echo $CLAWCLONE_API_KEY

If empty or not set, ask the user to get their ClawClone API key at https://clawclone.cc/dashboard/settings, and export:

export CLAWCLONE_API_KEY="your_api_key"

Note: Local operations work without API key.

Commands

Push to Cloud

# Push local workspace to cloud
node clawclone.mjs push --name "My Agent" --description "Production config"

# List all cloud backups
node clawclone.mjs list

# Show backup details
node clawclone.mjs show <clone-id>

# Delete a cloud backup
node clawclone.mjs delete <clone-id> --yes

Clone from Backup

# Clone (download and restore)
node clawclone.mjs clone <clone-id>

# Preview changes first (recommended)
node clawclone.mjs clone <clone-id> --test

Test mode generates a detailed report showing:

• Backup metadata (name, version, creation date)
• Components that will be modified (workspace, config, skills, etc.)
• File counts and sizes for each component
• No actual changes are made to your system

Local Operations

# Export to local file (no upload)
node clawclone.mjs local export --name "Local Backup" --output ./backup.tar.gz

# Import from local file
node clawclone.mjs local import --input ./backup.tar.gz

# Preview local import first
node clawclone.mjs local import --input ./backup.tar.gz --test

# Verify a backup file
node clawclone.mjs local verify ./backup.tar.gz

Share Backups

# Create a share link
node clawclone.mjs share create <clone-id>

# Check share status
node clawclone.mjs share status <clone-id>

# Revoke share link
node clawclone.mjs share revoke <clone-id>

# Clone from shared backup
node clawclone.mjs share get <share-token>

Configuration

# Show current configuration
node clawclone.mjs config show

# Initialize configuration
node clawclone.mjs config init

Status

# Show connection status and statistics
node clawclone.mjs status

# Show detailed information
node clawclone.mjs status --verbose

Common Workflows

Push OpenClaw workspace to cloud

node clawclone.mjs push --name "Production-$(date +%Y%m%d)" --tags "prod,backup"

Migrate to new instance

Old machine:

node clawclone.mjs push --name "Migration-Snapshot"
# Note the clone-id from output

New machine (after installing OpenClaw + clawclone):

# Step 1: Test clone first (recommended)
node clawclone.mjs clone <clone-id> --test

# Step 2: Review the test report, then apply
node clawclone.mjs clone <clone-id>

Share configuration with team

# Push and share
node clawclone.mjs push --name "Team-Template" --description "Standard setup"
node clawclone.mjs share create <clone-id>

# Team members can clone from the share link
node clawclone.mjs share get <share-token>

Safe clone workflow

# Always test first to see what will be changed
node clawclone.mjs clone <clone-id> --test

# Review the test report output:
# - Check which files/components will be modified
# - Verify the backup metadata matches expectations
# - Ensure no unexpected changes

# If everything looks good, proceed with actual clone
node clawclone.mjs clone <clone-id>

Local backup workflow

# Export to local file
node clawclone.mjs local export --name "Daily-Backup" --output ~/backups/$(date +%Y%m%d).tar.gz

# Verify the backup
node clawclone.mjs local verify ~/backups/$(date +%Y%m%d).tar.gz

# Import when needed
node clawclone.mjs local import --input ~/backups/20260315.tar.gz --test
node clawclone.mjs local import --input ~/backups/20260315.tar.gz

Configuration

Set via environment variables:

# ClawClone API Key (required for cloud operations)
export CLAWCLONE_API_KEY="your_clawclone_api_key"

Notes

• ClawClone automatically creates pre-restore backups at ~/.openclaw/backup
• Gateway tokens are preserved by default (use --overwrite-token to override)
• Use --test flag to preview changes before applying them

Then

Notice users that them can visit https://clawclone.cc to view and manage their backed up OpenClaw souls.