Openclaw Migration Pro

OpenClaw 环境迁移工具专业版。识别 Skills 与其维护数据的关联关系，完整迁移到另一个 OpenClaw 环境。打包 → 运输 → 归位，像搬家一样简单。

Install

openclaw skills install @yankj/openclaw-migration-pro

OpenClaw Migration Pro

一句话定位

像搬家一样迁移 OpenClaw 环境。

核心概念

你的东西 vs 房东的东西

你的东西（需要迁移）：

Memory（你的数据资产）
Skills（你创建/修改的）
Cron Jobs（你配置的任务）
工作区配置（SOUL.md, USER.md, AGENTS.md 等）
OpenClaw 配置（openclaw.json）

房东的东西（不需要迁移）：

OpenClaw 系统本身（新环境重新安装）
API Keys（应该重新配置）
Channel 配置（每台机器独立）

关联关系

每个 Skill 可能维护特定的数据目录：

Skill	维护的目录
just-note	memory/just-note/
finance-analyst	memory/finance-*/
daily-report	memory/daily-report/

迁移时需要保持这种关联关系。

快速开始

步骤 1: 分析（可选）

bash

# 分析当前环境
openclaw-migration-pro analyze ~/migration/

# 输出：
# 🔍 分析 OpenClaw 环境...
# 📦 Skills: ClawHub 安装 50 个，工作区本地 3 个
# 📝 Memory: 1090 个文件，50MB
# ⏰ Cron Jobs: 1 个

步骤 2: 打包（源电脑）

bash

# 打包所有数据（默认 ZIP 格式 + 自动发送）
openclaw-migration-pro pack --output ~/openclaw-pack.zip

# 输出：
# 📦 开始打包 OpenClaw...
# 📦 打包 Skills... ✅ 工作区 3 个，ClawHub 50 个
# 📦 打包 Memory... ✅ 1090 个文件
# 📦 打包配置... ✅ 已打包
# 📦 打包 Cron... ✅ 1 个
# 🗜️  正在压缩为 zip 格式...
# ✅ 打包完成：~/openclaw-pack.zip
# 📤 正在发送文件到当前频道...
# 备份大小：61MB

打包选项：

--compress zip（默认）：Mac/Windows 兼容格式
--compress tar.gz：Linux 推荐格式
--no-send：禁用自动发送
--versioned：带时间戳的版本化打包

步骤 3: 运输（用户手动）

bash

# 复制到 U 盘/网盘/网络
cp -r ~/openclaw-pack/ /mnt/usb-drive/
# 或
rsync -av ~/openclaw-pack/ user@new-pc:~/

步骤 4: 归位（目标电脑）

bash

# 1. 安装 OpenClaw（如果未安装）
curl -fsSL https://openclaw.ai/install.sh | bash

# 2. 归位
openclaw-migration-pro unpack --input ~/openclaw-pack/

# 输出：
# 🏠 开始归位 OpenClaw...
# 📦 恢复 Skills... ✅ 工作区 3 个，ClawHub 50 个
# 📦 恢复 Memory... ✅ 1090 个文件
# 📦 恢复配置... ✅ 已恢复
# 📦 恢复 Cron... ✅ 1 个
# ✅ 归位完成！
# 请重启 OpenClaw Gateway:
#   openclaw gateway restart

命令参考

analyze - 分析环境

分析当前 OpenClaw 环境，生成 MANIFEST.json。

bash

openclaw-migration-pro analyze [output-dir]

# 示例
openclaw-migration-pro analyze ~/migration/

输出:

Skills 数量（ClawHub vs 工作区）
Memory 文件数和大小
Cron Jobs 数量
MANIFEST.json

pack - 打包

根据分析结果打包所有数据。

bash

openclaw-migration-pro pack --output <dir>

# 示例
openclaw-migration-pro pack --output ~/openclaw-pack/

打包内容:

skills/workspace/ - 工作区 Skills（本地创建的）
skills/clawhub/ - ClawHub Skills（完整备份）
memory/ - 所有 Memory 文件
config/ - OpenClaw 配置 + 工作区配置
cron/ - Cron Jobs
BACKUP_INFO.md - 备份清单

排除内容:

API Keys（敏感信息）
Channel 配置（每台机器独立）
缓存文件（可自动生成）

unpack - 归位

在新环境恢复数据。

bash

openclaw-migration-pro unpack --input <dir>

# 示例
openclaw-migration-pro unpack --input ~/openclaw-pack/

归位流程:

检查 OpenClaw 是否安装
恢复 Skills 到正确位置
恢复 Memory 到正确位置
恢复配置文件
恢复 Cron Jobs
提示重启 Gateway

打包内容详解

Skills

类型	位置	说明
工作区 Skills	`skills/workspace/`	本地创建/修改的 Skills
ClawHub Skills	`skills/clawhub/`	从 ClawHub 安装的 Skills

策略:

工作区 Skills：完整打包
ClawHub Skills：完整打包（可选重新安装）

Memory

类型	位置	说明
日常 Memory	`memory/YYYY-MM-DD.md`	日记、笔记
Skill 维护	`memory/<skill-name>/`	Skills 维护的数据
项目文件	`memory/projects/`	项目相关

策略: 完整打包，保持目录结构

配置

文件	位置	说明
OpenClaw 配置	`~/.openclaw/openclaw.json`	Gateway 配置
工作区配置	`SOUL.md`, `USER.md` 等	工作区规则
Cron Jobs	`~/.openclaw/cron/`	定时任务

策略: 完整打包（不包括 API Keys）

最佳实践

1. 迁移前

停止 OpenClaw Gateway
运行 analyze 检查
确保有足够磁盘空间（至少 100MB）

2. 迁移后

3. 定期备份

bash

# 每周备份
0 3 * * 0 openclaw-migration-pro pack --output ~/weekly-backup/$(date +\%Y-\%m-\%d)/

故障排除

问题 1: 归位后 Skills 不可用

bash

# 检查工作区 Skills
ls -1 ~/openclaw/workspace/skills/

# 重新安装 ClawHub Skills
npx clawhub install just-note --force

问题 2: Memory 文件丢失

bash

# 检查打包内容
ls -1 ~/openclaw-pack/memory/

# 手动恢复
cp -r ~/openclaw-pack/memory/* ~/openclaw/workspace/memory/

问题 3: Cron Jobs 丢失

bash

# 检查打包内容
ls -1 ~/openclaw-pack/cron/

# 手动恢复
cp ~/openclaw-pack/cron/*.json ~/.openclaw/cron/

与其他工具对比

功能	openclaw-migration-pro	openclaw-backup	claw-sync
完整打包	✅	✅	❌
关联关系识别	✅	❌	❌
选择性打包	✅	⚠️	❌
配置恢复	✅	❌	❌
Cron 迁移	✅	✅	❌
Git 同步	❌	❌	✅

许可证

MIT License

贡献

Issues and PRs welcome!

GitHub: https://github.com/your-org/openclaw-migration-pro