Claw 时光机

要解决什么问题

OpenClaw 的日常运行依赖一批目录与配置文件，而不是整套安装包：workspace/、credentials/、telegram/、skills/、cron/、openclaw.json、identity/ 等。升级、改配置、换服务器时，如果只备份二进制或整盘镜像，要么体积过大，要么漏掉真正决定「这台 Claw 是谁、能干什么」的状态。

Claw Time Machine 用捆绑脚本把上述路径打成归档，默认落在 ~/.ctm/，并在每个包里附带 manifest.txt，便于核对本次捕获了哪些路径。

技能如何工作

脚本围绕四条子命令组织日常运维：

• backup [filename]：在变更前创建命名备份；不传文件名则由脚本按默认规则生成。
• list：按时间倒序列出已有备份，便于按文件名或「最新一条」做选择。
• restore [--force]：把选定归档写回上述状态路径；覆盖是破坏性的。非交互场景再考虑 --force。
• migrate [--remote-dir] [--clean-remote-archive] [--force]：先本地备份，再复制到目标机并在远端执行恢复；目标机不必预先安装本技能。恢复成功后可用 --clean-remote-archive 删掉远端上的归档副本。

典型流程：高风险操作前先 backup；需要回滚时先 list 再 restore；整机搬迁用 migrate 完成「打包—拷贝—远端恢复」一条龙。

边界与注意点

1. 恢复会覆盖脚本所管路径上的现有内容；执行前应确认脚本提示的自动安全备份路径，以便需要时还能回滚。
2. 本技能不会自动启停 Gateway；恢复后服务状态需你自行核对。
3. 目标环境若较特殊（路径、权限、远端目录约定），应先阅读技能内 references/usage.md 再迁机。
4. 更细的示例、迁机细节与失败处理，以 references/usage.md 为准。