OpenClaw Migration Skill

# OpenClaw Migration Skill

Migrate OpenClaw from one host to another via SSH.

Skill Metadata

Setup Commands

Prerequisites

1. SSH access to new host

2. SSH key (recommended for automation)

3. NPM installed on new host

Configuration

# Configure migration target
openclaw-migrate setup

# It will ask for:
# - New host IP/hostname (e.g., 192.168.1.50)
# - SSH user (e.g., crix)
# - SSH key path (optional, Enter for default)

Usage Commands

Main Migration

# Start migration (one command!)
openclaw-migrate migrate

Other Commands

# Test SSH connection
openclaw-migrate test

# Show current configuration
openclaw-migrate status

# Reconfigure target
openclaw-migrate setup

What Gets Synced

Files & Directories

| Source | Destination |

|--------|-------------|

| `~/.openclaw/` | `~/.openclaw/` (skills, memory, config) |

| `~/.config/openclaw/` | `~/.config/openclaw/` |

| OpenClaw npm package | Reinstalled if missing |

Environment Variables

| Variable | Description |

|----------|-------------|

| `HA_URL` | Home Assistant URL |

| `HA_TOKEN` | Home Assistant token |

| `GITHUB_TOKEN` | GitHub API token |

| `BRAVE_API_KEY` | Brave Search API |

| `GOOGLE_API_KEY` | Google API key |

| Any `HA_*` vars | All HA related vars |

System Data

Migration Flow

1. setup → Configure target host
2. test → Verify SSH connection
3. migrate → Full sync and start
   ├─ Check/Install OpenClaw
   ├─ Sync workspace (~/.openclaw/)
   ├─ Sync config
   ├─ Sync environment variables
   ├─ Sync cron jobs
   └─ Start gateway on new host

Error Handling

Related Skills

Files

openclaw-migrate/
├── SKILL.md       # This file
├── README.md      # User docs
├── main.js        # Migration CLI
└── config.json    # Saved target config