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#

bash

# 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#

bash

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

Restore#

bash

# 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.

bash

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.

bash

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.

bash

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

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

export#

Export specific components.

bash

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#

text

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#

ComponentDefaultQuickFullSkills✓✓✓Settings✓✓✓Memory✓✗✓Credentials✓✓✓History✗✗✓Workspace✗✗✓

Examples#

Example 1: Pre-Migration Backup#

bash

# 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#

bash

# 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#

bash

# 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#

bash

# 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

bash

# 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

bash

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

Git Repository

bash

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

Encryption#

Password Encryption#

bash

# 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#

bash

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

Automation#

Cron Job (Linux/macOS)#

bash

# 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)#

powershell

# 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:

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#

bash

# 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:

bash

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:

bash

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.