🛡️ Avenger 计划

面向任意 OpenClaw 系统的加密、基于分支的 GitHub 备份与恢复方案。

该技能的触发时机

1. 用户说出 "setup avenger" / "configure backup" / "avenger init" → 执行 SETUP 流程
2. 用户说出 "avenger backup" / "backup system" / "push to vault" → 执行 BACKUP 操作
3. 用户说出 "restore from vault" / "avenger restore" → 执行 RESTORE 流程
4. 用户说出 "avenger status" / "vault status" → 显示 STATUS 信息
5. 在任意确认的配置变更之后（例如 gateway 重启、配置补丁应用）→ 静默执行 BACKUP

SETUP 流程（由 Agent 引导）

当触发 setup 时，以对话方式逐步引导用户完成配置，每次仅提出一个问题。

第 1 步 — 请求 Vault 仓库地址

“为启用 Avenger 计划，我需要一个私有 GitHub 仓库作为您的 vault。您是否已创建？若已创建，请提供仓库 URL（例如：https://github.com/yourname/my-vault）。若尚未创建，我可以协助您新建。”

第 2 步 — 处理加密密钥

“您的 openclaw.json 文件（包含全部 API 密钥与 Bot Token）将在推送前使用 AES-256 加密。您是否已有先前 Avenger 配置中生成的加密密钥？还是需要我为您生成一个新的？”

第 3 步 — 执行 setup 脚本

bash ~/.openclaw/workspace/skills/avenger-initiative/scripts/setup.sh 
  --repo 

第 4 步 — 显示密钥并强调必须保存

“⚠️ 您的加密密钥如下 — 请立即保存至 1Password、Bitwarden 或其他安全笔记中。
丢失此密钥将导致备份内容无法解密。”

须等待用户明确确认“已保存”后，方可继续下一步。

第 5 步 — 说明将被备份的内容

• 🔐 openclaw.json — 已加密（含全部 API 密钥、Bot Token、Agent 配置）
• 🧠 所有记忆日志与工作区文件（SOUL、IDENTITY、MEMORY、TOOLS）
• 👥 所有 Agent 的专属文件
• 🔧 所有自定义技能
• 📋 Cron 任务定义

保留策略：

• 每日备份 → 保留最近 7 天
• 每周备份 → 保留最近 8 周（每周日生成）
• 每月备份 → 保留最近 12 个月（每月 1 日生成）

第 6 步 — 执行首次备份并安装 Cron 任务

bash ~/.openclaw/workspace/skills/avenger-initiative/scripts/backup.sh

BACKUP

bash ~/.openclaw/workspace/skills/avenger-initiative/scripts/backup.sh

创建 backup/daily/YYYY-MM-DD 分支 → 合并至 main 分支 → 按保留策略自动清理旧备份。
每逢周日：额外创建 backup/weekly/YYYY-WNN 分支。
每月 1 日：额外创建 backup/monthly/YYYY-MM 分支。

RESTORE

bash ~/.openclaw/workspace/skills/avenger-initiative/scripts/restore.sh

支持通过 --branch backup/daily/YYYY-MM-DD 参数从指定快照恢复。
执行前展示 vault 清单，请求用户确认；随后解密并还原全部文件。

恢复完成后需执行：openclaw gateway restart

STATUS

检查 ~/.openclaw/workspace/memory/avenger-backup.log 获取最近一次备份记录，显示时间戳、分支名及 vault URL。

文件路径

~/.openclaw/
├── credentials/
│   ├── avenger.key              ← 加密密钥（严禁提交至版本控制）
│   └── avenger-config.json     ← Vault 仓库 URL
└── workspace/skills/avenger-initiative/
    ├── SKILL.md
    ├── scripts/
    │   ├── backup.sh
    │   ├── restore.sh
    │   └── setup.sh
    └── references/
        └── security.md

安全模型

• Vault 仓库应在 GitHub 上设为 私有
• openclaw.json → 使用 AES-256-CBC 加密（PBKDF2 密钥派生，100,000 轮迭代）
• 其余所有文件 → 明文存储（不含任何敏感信息）
• 加密密钥仅存在于本地机器及用户的密码管理器中

详细威胁模型与密钥轮换机制参见 references/security.md。

更多经验证的 OpenClaw 技能请参阅 proskills.md