核心功能
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 小时默认保留期对长期审计需求不足