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...

# OpenClaw Migration Tool

Migrate OpenClaw from one host to another via SSH with one command.

## Features

- SSH-based remote migration
- Auto-install OpenClaw on new host
- Full configuration sync
- Skills and memory sync
- Environment variables sync
- Cron jobs sync
- One-command execution

## Quick Start

```bash
# Configure target
openclaw-migrate setup

# Run migration
openclaw-migrate migrate

# Test connection
openclaw-migrate test
```

## What Gets Synced

### Files
- `~/.openclaw/` - Workspace (skills, memory, config)
- `~/.config/openclaw/` - OpenClaw config
- OpenClaw npm package

### Environment Variables
- `HA_URL`, `HA_TOKEN`
- `GITHUB_TOKEN`
- `BRAVE_API_KEY`
- `GOOGLE_API_KEY`
- Any `HA_*` variables

### System
- Cron jobs

## Setup

```bash
$ openclaw-migrate setup
New host IP/hostname: 192.168.1.50
SSH user: crix
SSH key path: ~/.ssh/id_rsa
```

## Usage

```bash
# Configure once
openclaw-migrate setup

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

# Check everything works
openclaw-migrate test
```

## Requirements

- SSH access to target host
- SSH key (recommended)
- NPM on target host

## Error Handling

- Connection issues: Shows helpful error and retry option
- Missing OpenClaw: Auto-installs
- Sync failures: Reports which files failed

## Files

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

## License

MIT