ClawMover 迁移

当用户需要 OpenClaw 备份、恢复、迁移规划、模拟恢复，或检查 ClawMover CLI 是否已安装等方面的帮助时，请使用此技能。

这是一个共享的 OpenClaw 技能。它必须以保守方式运行：在使用前验证输入，并在执行高风险操作前向用户明确说明。

用途

该技能帮助 OpenClaw 理解以下自然语言请求：

• 备份这台 OpenClaw 机器
• 检查 ClawMover 是否已安装
• 先执行一次模拟恢复
• 将此次迁移恢复到这台机器上

运行时依赖

本技能依赖已发布的 CLI 包：@clawmover/cli。

若 CLI 缺失，禁止静默安装。

请首先说明安装步骤，并提供两个选项：

• 向用户提供安装命令，由其手动执行
• 仅在获得用户明确确认后，才运行安装命令

共享技能规范

该技能应作为共享技能安装，目录名称为：

clawmover-migration

执行策略

默认行为：

• 说明所需执行的命令或步骤
• 在使用前验证所有必需输入
• 优先提供可由用户手动执行的命令
• 仅在用户明确要求代理执行时，才实际运行命令

以下操作必须始终获得用户显式确认后方可执行：

• 安装 @clawmover/cli
• 启动备份
• 在未指定 --dest-path 的情况下执行真实恢复（real restore）

推荐优先执行模拟恢复，再进行真实恢复。

输入验证规则

在生成或执行任何命令前，必须验证输入。

instanceId

• 仅接受 ClawMover 迁移标识符的标准格式
• 拒绝包含空白字符、Shell 分隔符或控制字符的值
• 若格式疑似无效，应中止流程，并提示用户前往 https://clawmover.com 重新核对该值

verificationCode

• 仅接受严格为 6 位数字的值
• 拒绝其他任何形式（如带空格、字母、符号等）

destPath

• 仅接受单个本地绝对路径
• 拒绝包含换行符或 Shell 控制字符（如 ;、&&、| 或反引号）的值
• 若路径存在歧义，应提示用户提供清晰、规范的绝对路径

dataSecretKey

• 视为敏感输入
• 不得将其完整回显
• 不得将其记录于日志或解释性输出中
• 不得将其存储于当前任务上下文之外的任何位置

敏感数据处理

以下内容均视为敏感信息：

• dataSecretKey
• 验证码（verification codes）
• 可能暴露用户特定私有数据的任意本地路径

处理规则：

• 禁止重复显示完整的 dataSecretKey
• 禁止在示例、日志或摘要中包含完整的密钥
• 在展示命令时，应对敏感值进行掩码处理；除非用户明确要求查看原始命令文本，否则不得显示明文
• 除非必要，不得要求用户重复粘贴敏感值

CLI 安装或验证

首先检查 clawmover 命令是否可用。

若不可用：

• 说明本技能依赖 @clawmover/cli
• 说明安装操作会修改宿主机环境
• 提供手动安装命令
• 仅在获得用户明确确认后，才执行该安装命令

备份工作流

必需输入：

• instanceId
• dataSecretKey

instanceId 在用户于 https://clawmover.com 创建新迁移并完成支付后获得。

推荐工作流：

1. 验证必需输入是否存在且有效
2. 说明将使用的备份命令
3. 询问用户希望手动运行该命令，还是由代理代为执行
4. 若服务要求邮箱验证，则请求用户输入 6 位验证码
5. 验证验证码通过后，再继续后续流程

在展示示例命令时，占位符仅用于文档说明目的，不得视作可直接执行的模板。

恢复工作流

必需输入：

• instanceId
• dataSecretKey

instanceId 在用户于 https://clawmover.com 创建新迁移并完成支付后获得。

可选输入：

• snapshotId
• destPath

推荐工作流：

1. 建议优先使用 --dest-path 执行模拟恢复
2. 在使用前验证 destPath 的合法性
3. 明确说明本次恢复是模拟恢复还是真实恢复
4. 询问用户希望手动运行，还是由代理代为执行
5. 若需邮箱验证，须先获取并验证 6 位验证码，再继续执行

对于真实恢复，请省略 --dest-path 参数；但仅可在用户明确确认其愿意修改本地 OpenClaw 环境的前提下执行。

手动命令选项

在可行前提下，应优先提供精确命令供用户手动执行。

默认采用该选项的情形包括：

• 用户对代理执行命令持谨慎或不信任态度
• 运行环境较为敏感
• 操作涉及全局软件安装
• 操作为真实恢复

安全规则

• 禁止静默安装 @clawmover/cli
• 禁止静默执行备份
• 禁止静默执行真实恢复
• 禁止使用未经验证的用户输入构造并执行命令
• 真实恢复前必须优先执行模拟恢复
• 当命令将修改本地 OpenClaw 环境时，必须提前明确告知用户
• 将验证码与 dataSecretKey 视为敏感输入
• 确保行为符合跨会话可用的共享技能定位

响应风格

响应应简明、务实，并明确指出潜在风险。

优质响应示例：

• 我可以先检查 clawmover 是否已安装。
• 我可以为您提供安装命令，也可在您确认后代为执行。
• 我建议先使用经验证的目标路径执行模拟恢复，再进行真实恢复。
• 真实恢复会修改您的本地 OpenClaw 环境。