什么是Quick Backup and Restore (time machine)
Quick Backup and Restore（时间机器）是一款专为 OpenClaw 智能体设计的轻量级备份与恢复工具，旨在保护其运行时上下文——包括内存、会话状态、凭证和配置文件。由于智能体在运行过程中可能因逻辑错误或上下文覆盖导致数据损坏，该工具通过每小时自动快照的方式，提供近实时的时间点恢复能力。它基于 Restic 引擎构建，具备 AES-256 加密功能，确保备份数据安全且私密。整个系统默认静默运行，仅在发生异常时才会通过 Telegram 通知用户，避免日常操作中的干扰。
该工具的核心理念是‘精准回滚’：不同于传统的每日或每周全量备份，它允许用户在最近72小时内恢复到任意小时级的时间节点，例如精确回溯到两小时前某一关键决策之前的状态。这对于调试智能体的行为偏差、撤销误操作或修复上下文污染尤为有效。所有备份存储于本地指定目录（通常为 `{baseDir}/../../../var/backups/quick-backup-restore`），并通过配置文件进行管理，支持灵活的调度策略和保留策略定制。
尽管具备强大的本地恢复能力，需注意的是，此工具定位为‘时间机器层’，主要用于应对短期内的局部故障，而非灾难性恢复。因此，建议结合远程离线备份方案（如将 restic 仓库同步至外部服务器）以实现更全面的数据安全保障。此外，密码文件严格隔离于 `/etc/quick-backup-restore.pass`，权限设置为仅 root 可读写，防止意外泄露。
核心功能特点
- 每小时自动创建加密快照，支持最近72小时内任意时间点的精确恢复
- 基于 Restic 引擎，提供 AES-256 加密的本地备份仓库
- 静默运行模式，成功时不输出日志，仅在失败时通过 Telegram 告警
- 支持交互式恢复与命令行参数化恢复，可指定文件或完整快照回滚
- 内置完整性检查机制，可随时验证备份数据的可靠性
- 配置灵活，可通过 config.yaml 自定义备份路径、保留策略及通知设置
适用场景
Quick Backup and Restore 特别适用于需要频繁调试或迭代开发 OpenClaw 智能体的场景。例如，当智能体在一次对话中意外覆盖了重要记忆内容，或执行某项任务后导致后续推理出现系统性偏差时，用户可立即调用该工具，将内存状态回滚至问题发生前的某个稳定时刻，从而快速定位并修正错误根源。这种细粒度的时间旅行能力显著提升了开发效率与系统稳定性。
在生产环境中，若智能体因外部输入触发异常行为（如生成有害内容、陷入无限循环或丢失关键上下文），管理员无需重启整个服务即可快速恢复至安全状态。尤其适合部署在长期运行的服务容器中，作为第一道防线抵御‘软崩溃’。同时，对于需要审计或追溯历史决策路径的应用（如金融风控、法律合规类 AI 系统），该工具也能提供可靠的版本快照支持，便于事后复盘与分析。
需要注意的是，尽管该工具功能强大，但其作用范围局限于单台虚拟机内的 OpenClaw 实例。若遭遇硬件故障、磁盘损坏或大规模数据丢失，仍需依赖额外的远程备份策略进行灾难恢复。因此，推荐将其作为纵深防御体系的一部分，与离线备份协同使用，共同保障业务连续性。