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 才可在无人值守模式下运行。在无人值守运行中：严禁执行恢复操作、严禁修改配置、严禁创建或变更调度任务、严禁存储凭据。

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

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

“敏感 —— 强制加密”表示脚本拒绝为此类范围生成明文归档（退出码 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 文档逐步操作。概要如下：选择云服务商 → 用户按各服务商指南创建最小权限的 bucket 级别密钥 → 将凭据**存于 OpenClaw 配置之外**（推荐使用 AWS profile）→ 写入非密钥类配置（需确认）→ 测试连接 → 使用生成的密码短语文件启用加密 → 执行首次手动备份（需确认）→ 此后才可提供调度选项（需确认）。

凭据管理

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

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

调度机制 —— 严格采用选择加入（opt-in）模式

切勿默认、隐式或以“备份理应被调度”为由创建、修改或启用 cron 任务。技能文档仅说明如何配置 cron；是否启用完全由用户自主决定。

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

“备份已通过验证。是否需要我将其设为每日自动执行？我将为您创建如下 cron 任务——在您明确确认前，不会有任何任务被实际调度：”

随后运行 schedule 子命令打印确切命令，根据用户环境调整时间 / 时区 / 执行方式，完整展示命令文本，并等待用户明确确认后才执行。若用户拒绝，请立即放弃，且后续运行中不再重复提供（首次调用前请先检查 openclaw cron list —— 若已存在 cloud-backup 类型任务，则永不二次提供）。如需移除已有调度，请使用：openclaw cron rm 。

错误处理（面向代理自身）

• 将脚本 stderr 输出**原样**呈现给用户（仅裁剪至相关行）。切勿将错误概括为模糊描述，也绝不隐藏 WARN 级别提示。
• 非零退出码：依据退出码对照表诊断原因、向用户解释、仅提出**一项**修复建议。严禁自动重试 restore、prune 或任何 openclaw cron 修改类操作。backup 可重试一次，但前提是根本原因已修复且用户明确同意。
• 严禁擅自生成存储桶名称、端点或密码短语。缺失值 → 主动向用户询问。
• 退出码 14（加密必需但未提供密码短语）是设计上的硬性失败 —— 不得通过 --no-encrypt 或临时密码短语规避。请引导用户完成 setup 流程。
• 脚本在失败时会自动清理其 staging 目录；若报告无法清理，请向用户明确指出残留路径。

参考文档（按需查阅）

• 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 —— 威胁模型、恢复安全性、事件响应流程