# Openclaw Migrate

> OpenClaw Migration Skill

- Skill: `chris6970barbarian-hue/openclaw-migrate` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add chris6970barbarian-hue/openclaw-migrate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chris6970barbarian-hue/openclaw-migrate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: chris6970barbarian-hue (https://skillmd.com/u/chris6970barbarian-hue)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chris6970barbarian-hue/openclaw-migrate

---

# 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

1. SSH access to new host
2. SSH key (recommended for automation)
3. NPM installed on new host

### Configuration

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

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

### Other Commands

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