OpenClaw 云备份

OpenClaw 原生备份的云层组件。封装 openclaw backup create（配置、凭证、一致的 SQLite 快照、workspace），然后使用 GPG 加密并将归档上传至任意兼容 S3 的存储桶，支持保留策略、完整性校验与分阶段恢复。

所有命令格式：bash "{baseDir}/scripts/cloud-backup.sh" <子命令>

何时使用此技能 —— 以及何时不应使用

仅在用户明确提出关于 OpenClaw 备份的请求时执行：例如“备份 openclaw”、“恢复我的 openclaw 状态”、“为 openclaw 配置云备份”、“/cloud-backup”，以及类似表述。

• 通用性请求（如“备份我的项目”、“保存这个文件”、“恢复数据库”）不属于本技能职责范围。在操作前，请先向用户确认其真实意图。
• 切勿将本技能作为其他任务的副作用、主动触发或“顺手为之”地执行。
• 只读子命令（status、list、verify、schedule，以及任何带 --dry-run 参数的命令）可在用户发起备份相关询问后自由运行；其余所有操作均须通过下方所述的确认关卡（confirmation gates）。

确认关卡

在执行任何改变状态的操作之前，必须向用户清晰展示即将发生的全部动作，并获得其明确的“是”确认。每个操作对应一个独立关卡 —— 不得重复询问用户刚确认过的内容，也不得批量确认多个操作。

对已确认过的目标执行重复的手动备份无需新增确认关卡 —— 用户的请求本身即构成确认。但仍须在执行前回显一行简明计划（例如：“全量备份，已加密 → s3://bucket/prefix”）。

无人值守运行（cron）

调度任务的有效载荷仅表示该次运行对 backup 和 prune 操作已获操作员预授权。在无人值守运行中：严禁执行 restore、严禁修改配置、严禁创建或修改调度任务、严禁存储凭证。

备份模式 —— 各模式包含内容说明

当用户询问“哪些内容会被备份？”时，请回显下表：

“敏感 —— 强制加密” 表示脚本拒绝为此作用域生成明文归档（退出码 14）。请勿绕过该限制；若用户明确需要可共享的明文归档，请改而推荐 config.excludeSecrets=true。用户还可通过 config.exclude / config.include（相对于 state 的 glob 模式）精细调整备份范围。

子命令

退出码（请精确报告，尤其在 cron 场景中）：
0 成功 · 3 成功但含警告 · 4 参数错误 · 10 其他进程持有锁 · 11 缺少依赖 · 12 磁盘空间不足 · 13 云服务不可达/凭证错误 · 14 加密必需但不可用 · 20–25 创建/过滤/加密/上传/校验失败 · 30 恢复失败。

首次配置流程

请严格按 references/setup-flow.md 中的步骤操作。概要如下：选择服务商 → 用户依据各服务商指南创建最小权限的存储桶级密钥 → 将凭证存于 OpenClaw 配置之外（推荐使用 AWS profile）→ 写入非密钥配置（需确认关卡）→ 测试连接 → 使用生成的密码短语文件启用加密 → 执行首次手动备份（需确认关卡）→ 仅在此之后提供调度选项（需确认关卡）。

凭证管理

解析顺序与存储规则详见 references/credentials.md。硬性规则如下：

• 严禁将访问密钥或密码短语写入 openclaw.json（禁止使用 skills.entries.cloud-backup.env.*）。备份归档会包含该文件：若配置中存在明文凭证，则该凭证将被嵌入其所保护的每一个备份归档中。
• S3 凭证应存于 AWS 命名 profile（config.profile，推荐）或由操作员管理的进程环境变量中；密码短语则应存于权限为 600 的密码短语文件中（config.passphraseFile）。
• 若操作员已部署 OpenClaw 的密钥存储服务，可改由该服务提供凭证：config.accessKeyRef / config.secretKeyRef / config.passphraseRef 支持 OpenClaw SecretRefs（{source: env|file|exec}），其解析上下文为 .secrets.providers —— 包括类 1Password 的 exec 提供者。配置了但无法解析的引用将导致运行中止；不会降级回退。
• 优先采用密钥完全不出现于本对话中的流程：例如用户自行运行 aws configure --profile ... 及密码短语生成命令。
• 若脚本输出关于明文配置凭证的 DEPRECATED 警告，请原样呈现给用户，并提供 references/credentials.md 中的迁移指引。

调度机制 —— 严格启用制（opt-in only）

严禁默认、隐式或因“备份理应被调度”等原因自动创建、修改或启用 cron 任务。技能文档仅描述如何配置 cron；是否启用，完全由用户决定。

仅在首次成功完成手动备份后，提供一次调度选项：

“备份已通过验证。是否需要我为您每日调度？我将创建以下 cron 任务 —— 在您明确确认前，不会执行任何调度操作：”

随后运行 schedule 子命令打印确切命令，根据用户的实际环境调整时间、时区及交付方式，完整展示该命令，并等待用户明确确认“是”后才执行。若用户拒绝：立即放弃，且后续运行中不再重提（首次执行前请先检查 openclaw cron list —— 若已有 cloud-backup 相关任务，则永不重提）。如需移除调度任务，请使用：openclaw cron rm 。

错误处理（面向你，即代理）

• 将脚本 stderr 输出原样呈现给用户（可裁剪至相关行），切勿模糊总结错误，亦不可隐藏 WARN 级别警告。
• 非零退出码：依据退出码表诊断问题、解释原因，并仅提出一项修复建议。严禁自动重试 restore、prune 或任何 openclaw cron 修改类操作。backup 仅可在问题根源已修复且用户同意的前提下重试一次。
• 严禁臆造存储桶名、端点地址或密码短语。缺失值 → 主动询问。
• 退出码 14（必需加密但无可用密码短语）为设计上的硬性失败 —— 不得通过 --no-encrypt 或临时密码短语绕过。请运行 setup 流程。
• 脚本会在失败时自动清理暂存区；若报告无法清理，请向用户明确告知残留路径。

参考文档（按需查阅）

• references/credentials.md —— 凭证解析链、v1→v2 迁移、警告说明
• references/setup-flow.md —— 引导式首次配置流程
• references/providers/{aws-s3,cloudflare-r2,backblaze-b2,digitalocean-spaces,minio,other}.md
• references/security.md —— 威胁模型、恢复安全性、事件响应