Time Clawshine — OpenClaw Time Machine

⏱ 代理记忆的时光机 · 每小时加密快照

基于 restic 的增量加密快照系统,为 OpenClaw 代理提供每小时自动备份与精确回滚能力

收藏
5.9k
安装
1.4k
版本
3.1.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Time Clawshine 是一款专为 OpenClaw 代理设计的本地备份与恢复工具,核心能力包括:

  • 每小时增量快照:利用 restic 的增量去重技术,仅备份变更字节,存储高效
  • AES-256 加密:全仓库加密,密码文件独立管理(chmod 600)
  • 精准时间回滚:支持自然语言时间描述(如"2小时前""昨天")定位快照
  • 完整性验证:自动每日执行 restic check,支持手动仓库健康检测
  • 告警机制:失败时通过 Telegram 通知,支持 healthchecks.io 集成监控备份任务存活

显著优点

1. 零维护设计:systemd/cron 自动调度,setup.sh 一键部署
2. 存储效率:72 小时 × 每小时快照的默认配置下,仅存储差异数据

3. 安全离线:100% 本地运行,无强制云端依赖,Telegram 和更新检查均为可选

4. 操作友好:dry-run 模式、交互式恢复向导、状态仪表盘、自定义路径分析器

5. 防御性编程:磁盘空间保护(自动中止)、日志轮转、自测试脚本、干净卸载

局限性与风险

| 问题 | 说明 |
|------|------|
| **非灾难恢复方案** | 仅保护 3 天本地历史,VM/磁盘损毁时数据丢失;需额外配置远程备份 |
| **密码单点故障** | 丢失 password_file 即永久失去所有快照访问权 |
| **root 权限要求** | setup/backup/restore 均需 sudo,误操作可能影响系统 |
| **restic 依赖** | 自动安装但非系统原生包,边缘环境可能受网络/签名影响 |
| **无自动更新** | 检测到新版本仅记录警告,需用户手动执行更新 |

适合人群

  • OpenClaw 深度用户:频繁迭代代理配置、依赖 MEMORY.md 等上下文文件
  • 实验性开发者:需要安全网以回滚破坏性变更
  • 自托管运维:偏好本地优先、加密可控的备份策略
  • 有一定 Linux 基础的用户:能处理 yaml 配置、理解 restic 仓库概念

常规风险

  • 恢复至 / 路径前未确认可能覆盖当前工作数据
  • --purge 卸载参数不可逆删除备份仓库
  • 未单独备份 password_file 导致加密仓库无法解锁
  • 72 小时默认保留期对长期审计需求不足

Time Clawshine — OpenClaw Time Machine 内容

bin文件夹
手动下载zip · 42.7 kB
backup.shtext/x-shellscript
请选择文件