ClawSync - OpenClaw Configuration Sync

Never lose your OpenClaw setup again. One command to backup everything, one command to restore anywhere.

When to Use

✅ Use this skill when:

• "Backup my OpenClaw setup"
• "I'm moving to a new computer"
• "Sync settings between devices"
• "Export my skills and configuration"
• "Restore from backup"
• "Archive my OpenClaw data"
• "Share my configuration with team"

❌ Don't use when:

• Real-time sync needed (use dedicated sync tools)
• Only backing up specific files (use cp/rsync)

Features

1. Complete Backup

• Skills - All installed skills and configurations
• Memory - Agent memory, conversation history
• Settings - All .openclaw config files
• Credentials - Encrypted API keys and tokens
• Workspace - Projects and files
• History - Command and session history

2. Smart Restore

• Selective restore - Choose what to restore
• Version control - Keep multiple backup versions
• Conflict resolution - Handle existing files
• Cross-platform - Windows/macOS/Linux

3. Encryption & Security

• Password encryption - Protect sensitive data
• GPG support - Enterprise-grade encryption
• Selective encryption - Choose what to encrypt
• Secure deletion - Wipe temporary files

4. Storage Options

• Local - External drive, NAS
• Cloud - GitHub Gist, S3, Dropbox
• Git - Version controlled backups
• Compressed - ZIP with encryption

Quick Start

Create backup

# Full backup with encryption
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --encrypt

# Quick backup (skills + settings only)
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --quick

# Backup to specific location
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --output ~/Backups/openclaw_backup.zip

List backups

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py list

Restore

# Interactive restore
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore

# Restore specific backup
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore --backup ~/Backups/openclaw_20260322_120000.zip

# Restore to new machine
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore --backup backup.zip --fresh-install

Commands

backup

Create a complete backup of OpenClaw configuration.

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup [options]

Options:
  --output PATH         Output file/directory (default: timestamped in ~/clawsync-backups)
  --encrypt            Encrypt backup with password
  --gpg                Use GPG encryption
  --include-history    Include full conversation history
  --include-workspace  Include workspace files (may be large)
  --exclude-skills     Don't backup skills (use clawhub to reinstall)
  --quick              Quick backup (settings + skills only)
  --compress LEVEL     Compression level 1-9 (default: 6)

restore

Restore OpenClaw configuration from backup.

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore [options]

Options:
  --backup PATH        Backup file to restore from
  --selective          Choose what to restore
  --overwrite          Overwrite existing files
  --merge              Merge with existing configuration
  --fresh-install      Setup on new machine
  --dry-run            Preview changes

list

List available backups.

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py list [options]

Options:
  --location PATH      Backup directory to scan
  --details            Show detailed info

export

Export specific components.

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py export COMPONENT [options]

Components:
  skills               Export only skills
  memory               Export only memory
  settings             Export only settings
  credentials          Export credentials (encrypted)

Backup Contents

Structure

openclaw_backup_20260322_120000/
├── manifest.json           # Backup metadata
├── README.txt             # Restoration instructions
├── skills/                # All installed skills
│   ├── skill1/
│   ├── skill2/
│   └── ...
├── memory/                # Agent memory
│   ├── conversations/
│   ├── memory/
│   └── ...
├── settings/              # Configuration files
│   ├── config.yaml
│   ├── settings.json
│   └── ...
├── credentials/           # Encrypted credentials
│   └── credentials.enc
└── workspace/             # Workspace files (optional)

What's Included

Examples

Example 1: Pre-Migration Backup

# Before moving to new laptop
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup \
  --encrypt \
  --include-workspace \
  --output ~/migration_backup.zip

Output: Encrypted ZIP with everything needed to recreate setup.

Example 2: Daily Auto-Backup

# Add to cron/job scheduler
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --quick

Keeps last 7 days of quick backups automatically.

Example 3: Team Configuration Sharing

# Export only skills (no credentials)
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py export skills \
  --output team_skills.zip

# Team members import
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore \
  --backup team_skills.zip \
  --selective skills

Example 4: Disaster Recovery

# New machine, restore everything
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore \
  --backup openclaw_backup_20260322_120000.zip \
  --fresh-install

# Verify installation
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py verify

Storage Locations

Default Locations

• Linux/macOS: ~/clawsync-backups/
• Windows: %USERPROFILE%\clawsync-backups\

Cloud Integration

GitHub Gist

# Backup to private Gist
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --github-gist

# Restore from Gist
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore --github-gist GIST_ID

S3

# Backup to S3
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --s3-bucket my-backups

Git Repository

# Version-controlled backups
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --git-repo ~/dotfiles

Encryption

Password Encryption

# Will prompt for password
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --encrypt

# Or use environment variable
export CLAWSYNC_PASSWORD="secure_password"
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --encrypt

GPG Encryption

# Encrypt with specific GPG key
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --gpg --gpg-key user@example.com

Automation

Cron Job (Linux/macOS)

# Daily backup at 2 AM
0 2 * * * /usr/bin/python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --quick

# Weekly full backup
0 3 * * 0 /usr/bin/python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup

Task Scheduler (Windows)

# Create scheduled task
schtasks /create /tn "ClawSync Backup" /tr "pythonw.exe %USERPROFILE%\.openclaw\workspace\clawsync\scripts\clawsync.py backup --quick" /sc daily /st 02:00

Safety Features

• ✅ Dry-run mode - Preview what will be backed up/restored
• ✅ Incremental backups - Only changed files
• ✅ Rotation - Keep N recent backups, delete old ones
• ✅ Integrity check - Verify backup integrity
• ✅ Atomic operations - All-or-nothing restore

Configuration

Create ~/.clawsync/config.json:

{
  "backup_location": "~/Backups/OpenClaw",
  "retention": {
    "daily": 7,
    "weekly": 4,
    "monthly": 12
  },
  "encryption": {
    "enabled": true,
    "method": "password"
  },
  "exclude": [
    "*.log",
    "cache/",
    "tmp/"
  ],
  "auto_backup": {
    "enabled": true,
    "schedule": "0 2 * * *"
  }
}

Requirements

• Python 3.8+
• 7z/p7zip (for compression)
• GPG (optional, for encryption)
• Git (optional, for version control)

Installation

# Install dependencies
pip install -r ~/.openclaw/workspace/clawsync/requirements.txt

# Verify installation
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py --version

Troubleshooting

Large backups

Exclude workspace or use incremental backups:

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --exclude workspace

Permission errors

Ensure read access to ~/.openclaw and write access to backup location.

Corrupted backup

Verify integrity:

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py verify --backup backup.zip

Migration Guide

From Old Computer

1. Run backup on old machine
2. Transfer backup file (USB, cloud, scp)
3. Install OpenClaw on new machine
4. Run restore

To New Computer

1. Install OpenClaw
2. Install ClawSync skill
3. Restore from backup
4. Restart OpenClaw

License

MIT License - See LICENSE file

Support

For issues and feature requests, visit the GitHub repository.