前言¶

用 OpenClaw 搭过多 Agent 工作区的人，换电脑或重装系统时往往会卡在同一类问题上：SOUL、MEMORY、子代理 workspace、skills 目录和 openclaw.json 散落在 ~/.qclaw/ 各处，手工拷贝容易漏文件，合并配置又可能盖掉新机器上已有的 channel 或插件设置。下面介绍的 Quick Resurrection 把「打包旧环境」和「在新环境恢复」收成两条可复现命令，并在迁移前用 diff 与可选的 --dry-run 让你先看清会改什么。

这是什么¶

Quick Resurrection 是 SkillHub 上的社区 Skill（坐标 @user_c9715154/quick-resurrection，当前商店版本 v1.0.2，分类 ai-agent，标签 requires_api_key=false）。发布者为 user_c9715154，来源为 community。

一句话定位：在旧机器上把 Main Agent 与可选的子代理团队、skills、cron 与配置片段打成「搬家包」，在新机器上用 migrate.py 合并进 ~/.qclaw/ 并可选重启 Gateway。Skill 元数据声明依赖 openclaw 命令行（requires.bins: [openclaw]），面向 QClaw / OpenClaw 类运行时，而不是通用的 Cursor 项目配置导出。

核心功能¶

以下能力均来自 Skill 包内的 SKILL.md、README.md 与脚本说明，安装后可对照核实。

1. 打包（pack.py）
   从 openclaw.json 推断当前 active workspace，收集身份文件（SOUL、MEMORY、TOOLS、AGENTS 等）、团队成员目录（有则打包）、skills（有则打包）、cron 任务与 agent 配置片段，输出 zip。默认输出路径为 ~/一键搬家包/{Agent名称}搬家包_YYYYMMDD.zip（pack.py 文档亦提到带 _HHMMSS 的命名，以你本机脚本实际输出为准）。

2. 迁移（migrate.py）
   支持传入 zip 路径、解压后目录内执行，或当前目录下的包。流程包括：自动备份到 ~/.qclaw/backup/搬家备份_YYYYMMDD_HHMMSS/、复制身份与团队文件、合并 openclaw.json（agents 为 deep merge，hooks.allowedAgentIds 取并集，其余 channel/plugins 等保留新环境原值）、按清单创建 cron（可跳过已存在项）、最后可重启 Gateway。

3. 审查与安全开关
   官方推荐新环境首次使用 python3 migrate.py /path/to/搬家包.zip --dry-run 仅预览；可用 --no-cron、--no-restart 跳过定时任务创建或 Gateway 重启。文档强调搬家包含 MEMORY、TOOLS 等敏感内容，不应公开分享。

4. 子代理激活相关说明
   Skill 文档归纳「三要素」：agentId（人格）、cwd（workspace 隔离）、allowAgents（spawn 白名单），并说明迁移后需检查 openclaw-agents.json 中的 workspace 路径是否指向新环境。

安装与启用¶

SkillHub 页面给出的安装指引是：让 Agent 按 SkillHub 安装文档 安装 @user_c9715154/quick-resurrection。

若本机已有 skillhub CLI，可先确认版本，再安装到当前 Agent 的 skills 目录（必须使用 --dir，否则默认 ./skills/ 可能不会被客户端加载）：

command -v skillhub && skillhub --version

skillhub install quick-resurrection --namespace user_c9715154 --dir ~/.cursor/skills/

各客户端 skills 目录不同，安装文档中的常用路径包括：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

说明： 把 Skill 装进 Cursor 后，实际「打包 / 迁移」仍要在已安装 OpenClaw、且存在 ~/.qclaw/ 工作区的机器上执行 pack.py / migrate.py；仅安装 Skill 不会自动迁移本机 QClaw 数据。商店侧 SkillHub 评分约 100000，下载 668 次（页面统计，会随时间变化）。

典型用法¶

安装后，Skill 通常由自然语言触发（例如「我要搬家」「换电脑了」「帮我打包带走团队」）。可复现的命令流程如下。

旧环境打包：

cd ~/.qclaw/workspace/skills/quick-resurrection
python3 pack.py

将生成的 zip 拷贝到新机器（建议加密介质传输）。

新环境迁移（推荐先审查）：

python3 migrate.py /path/to/搬家包.zip --dry-run

确认 diff 与 cron payload 后执行：

python3 migrate.py /path/to/搬家包.zip

若需分步验证：

python3 migrate.py /path/to/搬家包.zip --no-cron --no-restart

迁移脚本会交互询问 Main Agent 处理方式（指向现有、新建实例或覆盖现有主控，见 SKILL.md 第三节）。完成后可用文档中的检查项验证 Gateway、SOUL 路径与 openclaw tasks list 等。

适用场景与注意¶

适合谁： 已在 ~/.qclaw/ 下运行 OpenClaw / QClaw，配置了 Main Agent 与可选子代理、cron、skills，需要在换机或重装后尽量「整包恢复」的团队或个人。

限制与注意：

• 依赖 openclaw CLI 与既有 QClaw 目录布局；未部署 OpenClaw 的环境无法直接跑通迁移脚本。
• 搬家包可能包含 API key、账号与私人记忆，需本地保管，文档明确反对公开分享。
• 配置合并以「不覆盖新环境无关配置」为原则，但若选择「覆盖现有 main agent」仍有数据替换风险，操作前应确认 ~/.qclaw/backup/ 备份可用。
• Skill 包内文档版本（如 README 标注的 v3.0 迁移逻辑）与 SkillHub 商店 semver（1.0.2）可能不一致，以你 skillhub install 得到的包内容为准。

结尾¶

Quick Resurrection 把 OpenClaw 多 Agent 工作区的打包、备份、配置合并与可选 cron/Gateway 步骤写进可脚本化流程，降低换机时的遗漏与误覆盖风险。官方 Skill 页与坐标：

• https://www.skillhub.cn/skills/user_c9715154/quick-resurrection
• https://api.skillhub.cn/user_c9715154/quick-resurrection