什么是 OpenClaw 迁移技能？

OpenClaw 迁移技能提供了一个自动化、安全的流程，用于将整个 OpenClaw 实例从一个主机传输到另一个主机。通过利用 SSH，它能确保在硬件升级或服务器转换期间，您的代理记忆、已安装技能和复杂配置保持持久。对于依赖 Openclaw Skills 且需要可靠方式来扩展或重新定位其 AI 代理基础设施而无需手动重新配置的用户来说，此工具至关重要。它处理从目录同步到环境变量持久化的所有事务，确保您的代理环境在几分钟内即可在新机器上投入生产。

下载入口:https://github.com/openclaw/skills/tree/main/skills/chris6970barbarian-hue/openclaw-migrate

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

OpenClaw 迁移技能 应用场景

• 将您的 AI 代理主机升级到更强大的硬件
• 将本地 OpenClaw 开发环境移动到生产环境 VPS
• 克隆代理配置以在不同服务器之间实现冗余
• 简化家庭实验室环境中新节点的设置

1. 运行设置命令以定义目标主机凭据和 SSH 参数。
2. 执行连接测试以验证主机之间的网络和身份验证路径。
3. 发起迁移以同步主工作区，包括技能和记忆。
4. 同步 Home Assistant 和 GitHub 等连接服务的环境变量和 API 令牌。
5. 将系统 cron 任务复制到新主机以维持自动化计划。
6. 在目标主机上自动启动 OpenClaw 网关以完成迁移。

OpenClaw 迁移技能 配置指南

在开始之前，请确保您拥有目标主机的 SSH 访问权限并已安装 NPM。安装技能，然后使用以下命令配置您的迁移目标：

# 初始化迁移目标配置
openclaw-migrate setup

# 验证与新主机的连接
openclaw-migrate test

# 执行完整迁移
openclaw-migrate migrate

按照交互式提示提供主机 IP、SSH 用户名和 SSH 密钥路径。

OpenClaw 迁移技能 数据架构与分类体系

迁移技能在系统之间映射以下数据结构和目录以确保一致性：

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

# 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

Environment Variables

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