OpenClaw Migration Pro

一句话定位

像搬家一样迁移 OpenClaw 环境。

核心概念

你的东西 vs 房东的东西

你的东西（需要迁移）：

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

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

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

关联关系

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

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

快速开始

步骤 1: 分析（可选）

CODEBLOCK0

步骤 2: 打包（源电脑）

CODEBLOCK1

打包选项：

• - --compress zip（默认）：Mac/Windows 兼容格式
• INLINECODE1：Linux 推荐格式
• INLINECODE2：禁用自动发送
• INLINECODE3：带时间戳的版本化打包

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

CODEBLOCK2

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

CODEBLOCK3

命令参考

analyze - 分析环境

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

CODEBLOCK4

输出:

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

pack - 打包

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

CODEBLOCK5

打包内容:

• - skills/workspace/ - 工作区 Skills（本地创建的）
• INLINECODE5 - ClawHub Skills（完整备份）
• INLINECODE6 - 所有 Memory 文件
• INLINECODE7 - OpenClaw 配置 + 工作区配置
• INLINECODE8 - Cron Jobs
• INLINECODE9 - 备份清单

排除内容:

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

unpack - 归位

在新环境恢复数据。

CODEBLOCK6

归位流程:

1. 1. 检查 OpenClaw 是否安装
2. 恢复 Skills 到正确位置
3. 恢复 Memory 到正确位置
4. 恢复配置文件
5. 恢复 Cron Jobs
6. 提示重启 Gateway

打包内容详解

Skills

策略:

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

Memory

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

配置

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

最佳实践

1. 迁移前

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

2. 迁移后

• - [ ] 检查 Skills 数量
• [ ] 检查 Memory 文件
• [ ] 检查 Cron Jobs
• [ ] 重新配置 API Keys
• [ ] 重新配置 Channel

3. 定期备份

CODEBLOCK7

故障排除

问题 1: 归位后 Skills 不可用

CODEBLOCK8

问题 2: Memory 文件丢失

CODEBLOCK9

问题 3: Cron Jobs 丢失

CODEBLOCK10

与其他工具对比

许可证

MIT License

贡献

Issues and PRs welcome!

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