🧬 kbird.ai

SYNC_GUIDE

2 min read

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 nosos@100.81.208.117:/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 nosos@100.81.208.117

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

Graph View

Backlinks