# OpenClaw 升级与回滚验收记录

## 变更身份

- 安装类型：npm / pnpm / Bun / git / container / other
- 当前版本：__________
- 目标版本与 channel：__________
- Node.js 版本：__________
- 变更窗口：__________
- 操作者：__________
- 回滚负责人：__________

## 升级前

- [ ] `openclaw update status --json` 已保存。
- [ ] `openclaw update --dry-run --json` 的目标、来源和动作已人工确认。
- [ ] `openclaw backup create --output <private-dir> --verify` 成功，manifest 已检查。
- [ ] 备份目录仅所有者可读，未上传到教程、工单或聊天。
- [ ] 版本、配置 lint、Gateway、Plugin、Channel、Approval、Browser 基线已记录。
- [ ] 已写明代码回退命令；需要状态恢复时另有离线恢复步骤。

## 升级后

- [ ] `openclaw --version` 等于批准目标。
- [ ] `openclaw doctor` 输出已阅读，没有未经确认执行 `doctor --fix`。
- [ ] Gateway 重启并通过 `openclaw health`。
- [ ] 八个金丝雀逐项记录实际结果，没有只验证 CLI 能启动。
- [ ] Plugin discovery 与运行健康分开验证。
- [ ] 关键渠道只用自有测试账号和唯一 token，没有向真实用户发测试消息。

## 回滚判定

- [ ] 配置或状态仍兼容旧版本时，先做代码层回退。
- [ ] 只有旧代码无法读取新状态时才考虑恢复升级前状态。
- [ ] 恢复状态前另存当前状态，并接受丢弃备份点后变更的影响。
- [ ] broad backup 先解压到 staging，按 manifest 离线恢复；没有假定存在整包原地激活命令。
- [ ] 回滚后重新执行版本、health、plugins、gateway deep status 和 doctor lint 检查。

## 结论

- 决策：通过 / 回滚 / 暂停观察
- 失败的 canary_id：__________
- 实际影响：__________
- 后续动作与负责人：__________

本站依据当前官方 Updating 文档整理此空白记录，没有升级你的环境，也没有证明某一版本适合你的安装方式。自动预更新配置副本不是完整状态恢复点；备份可能包含凭据和渠道状态，必须按敏感数据保护。