核心用法
Time Clawshine 是一款为 OpenClaw 代理设计的本地备份与恢复解决方案，基于成熟的 Restic 备份引擎构建。核心工作流为：安装 → 自动定时备份 → 按需精确恢复。
安装配置：运行 sudo bash {baseDir}/bin/setup.sh 完成初始化，支持 --no-system-install（仅仓库初始化）和 --assume-yes（无人值守模式）。首次安装前建议阅读 SETUP_GUIDE.md 交互式配置 Telegram 通知、备份频率、保留策略等参数。
备份机制：每小时自动执行增量快照，仅存储变更字节（deduplication）。默认保留 72 个快照（3 天），支持自定义保留策略。备份内容涵盖代理记忆、会话状态、配置文件等关键数据。
恢复能力：支持多维度恢复——按时间描述（"2h ago"、yesterday）、按快照 ID、按特定文件路径。restore.sh 默认先执行 dry-run 预览，确认后执行真实恢复。支持 --target 指定临时目录，避免直接覆盖。
状态监控：status.sh 提供一体化健康面板，涵盖仓库状态、磁盘空间、快照数量、更新提示。可选 Telegram 通知，失败时 60 秒内推送告警。支持 healthchecks.io 风格端点监控，确保"备份停止运行"也能被感知。
运维工具集：prune.sh 手动清理旧快照释放空间；test.sh 执行备份→恢复→验证的完整自测；customize.sh 离线分析系统路径，智能建议额外备份项与排除规则。
显著优点
- 精确时间机器：小时级粒度，可回滚至故障前 exact 时刻，非"昨日备份"
- 存储高效：Restic 增量去重，仅存储变更字节，磁盘占用极低
- 安全加密：AES-256 加密仓库，密码文件独立管理（chmod 600）
- 零维护设计：安装后全自动运行，cron/systemd 静默调度，失败才告警
- 完整性保障：每日自动
restic check，test.sh支持端到端验证 - 灵活恢复：时间描述、快照 ID、单文件三级恢复粒度
- 完全离线：核心功能无需网络，Telegram 与更新检查为可选项
- 安全卸载：
uninstall.sh可选择保留或清除数据，避免误删
潜在缺点与局限性
- 本地单点风险：默认存储于本地磁盘，非灾难恢复方案（建议额外配置远程备份）
- 密码文件依赖：丢失密码文件即永久失去所有快照访问权，需独立备份
- Restic 学习曲线：高级操作（如手动
restic diff）需理解 Restic 命令行 - Linux 专属：依赖 bash/systemd/cron，无 Windows/macOS 原生支持
- 磁盘空间敏感：虽有过载保护，但 72 小时高频快照在数据量大的场景仍可能吃紧
- Telegram 配置门槛：需自行申请 bot_token/chat_id，非开箱即用
适合人群
- OpenClaw 代理的重度用户，依赖代理记忆与上下文持续演进
- 需要"试错安全网"的开发者，频繁调试代理行为
- 追求自动化、低维护成本的基础设施管理员
- 有基础 Linux 操作能力，能接受命令行交互的用户
常规风险
- 密码文件泄露：攻击者获取密码文件可解密全部历史快照
- 本地磁盘故障：单点存储模式，物理损坏导致备份与原始数据同时丢失
- 恢复误操作：直接恢复到
/可能覆盖当前工作状态，建议先用--target验证 - 配置漂移：手动修改
config.yaml后未重新运行 setup，导致调度与配置不一致 - 权限问题：部分操作需 sudo，配置不当可能导致备份失败或文件所有权混乱