hermes agent数据可恢复：一、重命名备份还原（~/.openclaw.pre-migration）；二、tar快照解压覆盖工作区；三、checkpoint工具精准回滚。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你执行hermes rollback后发现工作区文件被清空、会话历史消失、甚至配置目录变成空壳，这不是数据真正丢失，而是Hermes Agent在回滚过程中触发了迁移后清理机制，将原始数据重命名备份而非删除——只要没手动rm -rf，所有内容都还在磁盘上原封不动地躺着。
确认数据是否真被删了
先别慌着重装或重建。打开终端，直接运行：
ls -la ~/.openclaw.pre-migration
如果这个目录存在且非空，说明你遇到的是典型的“重命名假删除”——【这是最常见也最容易误判的紧急场景】。Hermes在二次执行hermes claw migrate --yes时，会把原~/.openclaw自动改名为.pre-migration后缀目录，再新建一个空目录覆盖原路径。你看到的“空”，只是新壳子。
若该目录不存在，再检查：
ls -la ~/.hermes/checkpoints/
找回 .pre-migration 目录中的全部配置
这一步必须在停止所有Hermes进程后操作，否则可能引发文件锁冲突。
第一步：执行hermes stop或pkill -f hermes确保无残留进程。
第二步：将备份目录还原为原始路径：
mv ~/.openclaw.pre-migration ~/.openclaw
注意：如果~/.openclaw当前是空目录，系统允许直接mv覆盖；但如果该路径下已有新生成的临时文件，mv会报错，此时需先rm -rf ~/.openclaw再执行还原——【务必确认目标路径下没有你需要保留的新数据】。
第三步：重启Agent验证：
hermes run
从 checkpoint.tar.gz 恢复工作区文件
适用于非Git环境且误删的是工作区代码、文档等文件，而非核心配置。
方法一：快速定位最新快照
ls -t ~/.hermes/checkpoints/ | head -n1
方法二：解压覆盖当前目录
tar -xzf ~/.hermes/checkpoints/$(ls -t ~/.hermes/checkpoints/ | head -n1)/checkpoint.tar.gz -C ./
这一步会直接覆盖当前工作区所有同名文件。如果你只丢了部分文件，建议先用tar -tzf预览包内结构，再指定路径解压，避免误覆写新改文件。
用 hermes checkpoint restore 回滚到指定检查点
当hermes rollback交互式列表里出现多个可选恢复点，且你知道误删前最后一次正常状态对应的时间戳，就用这个命令精准还原。
① 列出全部检查点：
hermes checkpoint list
② 找到目标ID（形如chkpt-20260608-142219），执行：
hermes checkpoint restore --id chkpt-20260608-142219
③ 系统自动停服→加载SQLite快照→重建上下文→重启Agent。整个过程无需手动干预数据库文件。
这一步完成后，会话历史、工具调用链、响应记录全部恢复，但工作区文件是否同步取决于该检查点是否启用了Git模式或文件快照模式。
