ClawClone

OpenClaw workspace management tool - Push, clone, and migrate your OpenClaw configurations. Save the Soul of your OpenClaw.

📖 Overview

ClawClone is a powerful cli and skill that enables you to backup, share, and clone your OpenClaw Agent configurations across devices and teams.

✨ Features

• � Backup workspace - Backup and push your complete OpenClaw workspace to cloud
• 📦 Clone configurations - Download and restore Agent configurations instantly
• ☁️ Cloud storage - Secure cloud storage for all your clones
• 🔄 Cross-device sync - Keep your Agent settings synchronized across multiple devices
• 👥 Team sharing - Share configurations with your team members
• 🔒 Secure backup - Automatic backup of existing configurations to prevent data loss

🚀 Quick Start

Installation

Via npm (Recommended)

# Use npx directly (no installation required)
export CLAWCLONE_API_KEY="your_api_key_here"
npx clawclone push --name "my-backup"

# Or install globally
npm install -g clawclone
clawclone --version

Via ClawHub

clawhub install clawclone

Configuration

Set up your API key to enable cloud operations:

# Set your API key
export CLAWCLONE_API_KEY="your_clawclone_api_key_here"

Configuration File Method

Create a .env file in your project directory:

# Edit with your API key
CLAWCLONE_API_KEY=your_clawclone_api_key_here

📚 Usage

Basic Commands

# Push workspace to cloud
clawclone push --name "MyAgent" --description "Production config"

# List all your clones
clawclone list

# Clone from cloud
clawclone clone <clone-id>

# Check current status
clawclone status

# Export to local file (no API key needed)
clawclone local export --name "Backup" --output ./backup.tar.gz

# Import from local file (no API key needed)
clawclone local import --input ./backup.tar.gz

Command Reference

push - Push workspace to cloud

Create a package of your current workspace and push it to the cloud.

clawclone push --name "Name" --description "Description" --tags "tag1,tag2"

Parameters:

• --name (required): Clone name
• --description (optional): Clone description
• --tags (optional): Tags, comma separated

list - List all clones

Display all your uploaded clones.

clawclone list [--format table|json]

Parameters:

• --format (optional): Output format (default: table)

clone - Clone from cloud

Download a specific clone from the cloud and apply it to your current workspace.

clawclone clone <clone-id> [--test] [--no-backup] [--overwrite-token]

Parameters:

• <clone-id> (required): Clone ID
• --test (optional): Preview changes without applying
• --no-backup (optional): Skip creating pre-restore backup
• --overwrite-token (optional): Overwrite local Gateway Token

delete - Delete cloud clone

Delete a specific clone from the cloud.

clawclone delete <clone-id> --yes

Parameters:

• <clone-id> (required): Clone ID
• --yes (optional): Skip confirmation

local export - Export to local file

Create a workspace package and save it locally (no upload).

clawclone local export --name "Name" --output ./file.tar.gz

Parameters:

• --name (required): Clone name
• --description (optional): Clone description
• --tags (optional): Tags, comma separated
• --output (optional): Output file path

local import - Import from local file

Import a clone from a local file and apply it to your current workspace.

clawclone local import --input ./file.tar.gz [--test] [--no-backup]

Parameters:

• --input (required): Input file path
• --test (optional): Preview changes without applying
• --no-backup (optional): Skip creating pre-restore backup

status - Show status

Display ClawClone current status and statistics.

clawclone status

📁 What Gets Backed Up

ClawClone automatically backs up your OpenClaw workspace located at ~/.openclaw/workspace, including:

• Agent configurations
• Skill definitions
• Custom settings and preferences
• Workspace data and files

🔒 Security

• Authentication: Bearer Token authentication for secure API access
• Encrypted Transfer: All data transmitted over HTTPS
• Automatic Backup: Existing configurations are backed up before restoration
• Data Integrity: File integrity verification during backup and restore

🆘 Support

• 📖 Home