Agent Rollback（Agent回滚）是指将AI Agent的配置、技能、模型版本或整个系统状态恢复到之前某个稳定版本的操作。当新配置导致Agent行为异常、新技能引入Bug、或模型升级后输出质量下降时，回滚是最快的"止血"手段。
| 层次 | 回滚对象 | 方法 | 影响范围 |
|---|---|---|---|
| 配置层 | SOUL.md, USER.md, TOOLS.md | Git revert / 备份恢复 | 单个Agent |
| 技能层 | SKILL.md, 技能脚本 | Git版本切换 | 使用该技能的Agent |
| 模型层 | 模型版本、参数 | 配置修改 + 重启 | 使用该模型的Agent |
| 系统层 | OpenClaw版本、依赖 | 包管理器回退 | 所有Agent |
| 数据层 | 生成的文件、数据库 | 备份恢复 / Git回退 | 受影响的数据 |
# 最佳实践：Agent工作区用Git管理
cd ~/.openclaw/agents/miaoquai
# 查看配置变更历史
git log --oneline -10
# 回滚到上一个版本
git revert HEAD
# 回滚到指定版本
git checkout abc1234 -- SOUL.md
# 回滚后重启Agent使其生效
openclaw gateway restart# 技能目录也用Git管理
cd ~/.openclaw/skills/my-skill
# 查看技能变更
git log --oneline -- SKILL.md
# 回滚技能文件
git checkout HEAD~1 -- SKILL.md
# 或者从备份恢复
cp /backup/skills/my-skill/SKILL.md ./SKILL.md# 修改Agent使用的模型
# ~/.openclaw/config.yaml
agents:
list:
- id: "miaoquai"
model: "claude-sonnet-4" # 从新模型回滚到稳定版本
# model: "claude-sonnet-5" # 注释掉新模型
# 重启生效
openclaw gateway restart# 查看当前版本
openclaw --version
# 回滚到指定版本
npm install -g openclaw@2026.5.28
# 或使用pnpm
pnpm install -g openclaw@2026.5.28
# 重启
openclaw gateway restart# 如果Agent生成了错误的文件
# 使用Git回退网站文件
cd /var/www/miaoquai
git log --oneline -5
git revert HEAD
# 或者从备份恢复
rsync -av /backup/miaoquai/2026-06-18/ /var/www/miaoquai/| 策略 | 速度 | 风险 | 适用场景 |
|---|---|---|---|
| Git Revert | 快 | 低 | 配置、代码文件 |
| Git Checkout | 快 | 中（覆盖当前） | 单个文件回退 |
| 备份恢复 | 中 | 低 | 数据、数据库 |
| 蓝绿部署 | 极快 | 低 | 整个系统回退 |
| 版本切换 | 快 | 中 | 依赖、模型版本 |
陷阱1：没有版本控制 — 如果配置文件没有用Git管理，回滚就成了"凭记忆恢复"。一定要用Git管理所有Agent配置。
陷阱2：回滚后忘记重启 — 修改了配置文件但没有重启Agent，新配置不会生效。
陷阱3：回滚范围不够 — 只回滚了SOUL.md，但相关的TOOLS.md也改了，导致不一致。回滚时要注意关联文件。
1. 一切皆版本控制 — SOUL.md、SKILL.md、config.yaml、模板文件全部纳入Git。
2. 变更前打Tag — 每次重大变更前打Git Tag，回滚时可以直接checkout到tag。
3. 小步快跑 — 每次只改一个文件，确认正常后再改下一个。避免"一口气改10个文件然后发现出问题"。
4. 自动化回滚 — 配置健康检查，当Agent异常时自动回滚到上一个稳定版本。
5. 回滚演练 — 定期练习回滚操作，确保在紧急情况下能快速执行。