SYNC_GUIDE

OpenClaw Settings Sync Guide

Quick Sync (Manual)

From Mac to Legion (Fedora)

Step 1: On Mac - Export settings

cd ~/.openclaw
tar -czf ~/openclaw_settings_backup.tar.gz openclaw.json skills/ agents/ memory/

Step 2: Copy to Legion

# Option A: SCP (if SSH key is set up)
scp ~/openclaw_settings_backup.tar.gz [email protected]:/tmp/
 
# Option B: USB drive, cloud storage, etc.

Step 3: On Legion - Import settings

# Stop OpenClaw
openclaw stop
 
# Backup existing
mv ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
 
# Extract new settings
tar -xzf /tmp/openclaw_settings_backup.tar.gz -C ~/.openclaw
 
# Fix permissions
chmod 600 ~/.openclaw/openclaw.json
 
# Start OpenClaw
openclaw start
 
# Verify
openclaw status

Automated Sync (Script)

One-time setup:

# Copy sync script to Mac
cp ~/.openclaw/workspace/sync_openclaw_settings.sh ~/sync_openclaw.sh
chmod +x ~/sync_openclaw.sh

Run sync:

~/sync_openclaw.sh [email protected]

What Gets Synced

Essential files:

• openclaw.json - Main configuration (models, API keys, TTS)
• skills/ - Skill configurations and API keys
• agents/ - Agent definitions
• memory/ - Memory files and context

Not synced (machine-specific):

• logs/ - Log files
• media/ - Downloaded media
• extensions/ - Extension binaries
• credentials/ - Cached credentials

Troubleshooting

404 Error on Legion:

• Check openclaw.json has correct model settings
• Verify API keys are valid
• Check gateway configuration

Permission Denied:

chmod 600 ~/.openclaw/openclaw.json
chmod 700 ~/.openclaw

Model not found:

• Ensure model names in config match available models
• Check API key permissions

Emergency Recovery

If sync breaks everything:

# On Legion
openclaw stop
mv ~/.openclaw/openclaw.json.bak.* ~/.openclaw/openclaw.json
openclaw start

Contact Loss Protocol

If you lose access to this Mac:

1. Legion has the sync script at ~/.openclaw/workspace/sync_openclaw_settings.sh
2. Reverse sync possible: Copy from Legion back to Mac
3. Key settings are in openclaw.json - back this up separately

Current Working Config (Mac)

Key settings that work:

• Model: kimi-coding/kimi-k2
• TTS: ElevenLabs with voice clone
• Gateway: Local mode
• Skills: sag (ElevenLabs), goplaces, nano-banana-pro

Last synced: 2026-02-19