OpenClaw Migration Skill
Migrate OpenClaw from one host to another via SSH.
Skill Metadata
- Name: openclaw-migrate
- Type: OpenClaw Skill
- Purpose: Migrate all OpenClaw config, skills, memory, tokens to new host
Setup Commands
Prerequisites
- SSH access to new host
- SSH key (recommended for automation)
- 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
- Cron jobs (via crontab)
- OpenClaw gateway configuration
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
- SSH connection failed: Show retry option
- OpenClaw not on remote: Offer to install
- Sync failed: Report which files failed
- Config missing: Prompt for setup
Related Skills
- skillstore (search/install skills)
Files
openclaw-migrate/
├── SKILL.md # This file
├── README.md # User docs
├── main.js # Migration CLI
└── config.json # Saved target config
chris6970barbarian-hue