⏰ 时间机器（Time Machine）

面向 OpenClaw 配置的 Git 风格版本控制。支持备份、回滚与安心恢复。

为何需要时间机器？

是否曾因一次配置修改导致整个系统崩溃？是的，我们都经历过。

时间机器会自动为你的 OpenClaw workspace 创建快照——当问题发生时，你可立即回滚至任意历史版本。你可以把它理解为“助手大脑的 Git”。

快速开始

# 创建快照
/snap save

# 查看所有快照
/snap list

# 回滚至上一版本
/snap rollback

# 回滚至指定版本
/snap rollback v15

# 查看某快照内容
/snap view v15

哪些内容会被备份？

核心配置：

• openclaw.json — 主配置文件
• config.yaml — 系统配置
• agents/*.json — Agent 定义
• channels/* — 通道配置
• skills/* — 技能配置
• credentials/* — 密钥（已加密）
• .env — 环境变量

你的记忆：

• MEMORY.md — 长期记忆
• memory/*.md — 每日笔记

工作原理

增量式快照（Incremental Snapshots）

首次快照 = 全量备份（所有文件）
后续快照 = 仅记录自上次快照以来变更的文件（差分补丁）

v1_full/    → 所有文件的完整副本
v2_inc/     → 自 v1 起发生变化的文件
v3_inc/     → 自 v2 起发生变化的文件

效果： 快速、轻量的备份，显著节省磁盘空间。

智能恢复（Smart Recovery）

执行回滚时：

1. 加载最近一次全量快照
2. 按顺序依次应用各增量补丁
3. 完成 ✓

命令说明

/snap save

创建快照。触发词包括：“save snapshot”、“backup now”、“create backup”、“保存快照”

/snap list

列出所有快照及其时间戳。触发词包括：“list snapshots”、“show backups”、“查看快照”

/snap view vX

预览某快照内容。触发词包括：“view snapshot”、“show backup details”

/snap rollback

回滚至上一版本。执行前先显示预览，并请求确认。

变体用法：

• rollback v15 — 回滚至指定版本
• rollback --only memory — 仅恢复 memory 相关文件
• rollback --only config — 仅恢复 config 相关文件
• rollback openclaw.json to v10 — 单文件恢复

/snap delete vX

删除某快照。触发词包括：“delete snapshot”、“remove backup”

自动快照（Auto-Snapshot）

在 openclaw.json 中启用自动备份：

{
  "timeMachine": {
    "enabled": true,
    "autoSnapshot": {
      "onChange": true,
      "schedule": "0 3 * * *",
      "retentionDays": 7,
      "maxCount": 50
    }
  }
}

• onChange：在执行高风险配置变更前自动创建快照
• schedule：Cron 表达式，用于定时自动备份（默认：每日凌晨 3 点）
• retentionDays：自动删除早于 X 天的旧快照
• maxCount：仅保留最近的 X 个快照

危险操作防护（Danger Zone Protection）

当用户尝试修改关键配置文件时，时间机会提示：

“⏰ 是否在修改前创建快照？”

该机制为你自动建立安全恢复点。

输出示例

快照创建成功

✅ 创建快照 v15_inc（增量式）
📝 基于 v10_full
📁 变更文件：openclaw.json, channels/telegram.json
💾 已保存：仅 2 个补丁（2.3KB）

回滚预览

⚠️ 即将回滚至 v14_inc
📄 将恢复：openclaw.json
❓ 确认？（yes/no）

回滚完成

✅ 已回滚至 v14_inc
📦 自动创建 v15 作为本次回滚的锚点

边界情况（Edge Cases）

• 首次使用： 自动创建初始全量快照
• 损坏快照： 自动跳过异常快照，从最后一个有效快照恢复
• 磁盘空间不足： 向用户发出警告，暂停新快照创建，保留已有快照
• 单文件操作： 支持部分回滚（仅恢复单个文件）

脚本（Scripts）

scripts/ 目录下的 Python 脚本：

• snapshot.py — 创建快照
• restore.py — 从快照恢复
• list.py — 列出所有快照
• cleanup.py — 自动清理旧快照

运行方式示例：python scripts/snapshot.py 等。

一句话总结（TL;DR）： 启用时间机器，从此告别配置灾难。你的助手，始终为你兜底。