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/ ``` **归位流程**: 1. 检查 OpenClaw 是否安装 2. 恢复 Skills 到正确位置 3. 恢复 Memory 到正确位置 4. 恢复配置文件 5. 恢复 Cron Jobs 6. 提示重启 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. 迁移后 - [ ] 检查 Skills 数量 - [ ] 检查 Memory 文件 - [ ] 检查 Cron Jobs - [ ] 重新配置 API Keys - [ ] 重新配置 Channel ### 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