Time Clawshine — OpenClaw Time Machine

⏱ 智能体记忆时光机 · 小时级精准回滚

开源增量备份工具,每小时加密快照 OpenClaw 智能体数据,支持精准回滚与自动告警

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

使用说明

核心用法

Time Clawshine 是基于 restic 的增量备份技能,专为 OpenClaw 智能体设计。通过每小时自动创建 AES-256 加密快照,完整保护 memory、会话上下文及配置文件。用户可通过 backup.sh 手动触发、restore.sh 精准回滚至任意时间点(支持 "2h ago" 自然语言),并通过 status.sh 查看健康状态。

安装采用单命令交互式引导:sudo bash {baseDir}/bin/setup.sh,支持 --no-system-install 纯仓库模式、--assume-yes 自动化部署。配置集中管理于 config.yaml,涵盖备份频率、保留策略、Telegram 告警、额外路径等。

显著优点

  • 秒级增量:仅存储变更字节,dedup 机制节省 90%+ 空间
  • 精准回滚:支持自然语言时间表达式("yesterday"、"2h ago"),非昨日整点
  • 零维护设计:systemd/cron 自动调度,失败时 Telegram 60 秒内告警
  • 完整性保障:每 24 次备份自动 restic check,test.sh 验证备份→恢复→校验闭环
  • 安全默认:100% 离线运行,AES-256 加密,密码文件强制 600 权限
  • 磁盘保护:剩余空间不足时自动中止,防止备份填满分区

潜在缺点与局限性

  • 非灾难恢复方案:本地仓库,无远程复制;物理机损坏即丢失
  • 密码单点故障:丢失 password_file 则所有快照不可恢复,需独立备份
  • OpenClaw 专用:restic 通用但 wrapper 脚本绑定特定目录结构
  • Telegram 依赖:告警需外部网络,纯内网环境失效
  • 72 小时默认窗口:长期历史需手动调整 retention 或配合外部备份

适合人群

  • OpenClaw 智能体重度用户,依赖 MEMORY.md 长期记忆
  • 需要小时级粒度回滚的开发者/运维人员
  • 追求「安装后忘记」自动化体验的用户
  • 具备基础 Linux 能力、能处理密码文件备份的技术用户

常规风险

| 风险场景 | 说明 | 缓解措施 |
|---------|------|---------|
| 密码文件丢失 | 无密码无法解密任何快照 | 打印/离线存储 password_file 副本 |
| 磁盘填满 | 备份持续增长 | 启用 disk guard,定期运行 prune.sh |
| 静默失败 | cron 无 Telegram 时失败难察觉 | 配置 healthcheck.io ping 或定期检查日志 |
| 误恢复覆盖 | restore.sh 默认提示,但 --force 可跳过 | 始终先 `--dry-run`,恢复至 /tmp 预览 |
| 仓库损坏 | 底层存储故障 | 配合远程 restic 仓库做 3-2-1 备份 |

Time Clawshine — OpenClaw Time Machine 内容

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