# 用已记录基线检查升级结果

记录实际 CLI 与 gateway 版本，保留恢复资料，升级后复查对话、工具、记忆、消息和定时任务。

- 引用: https://botclaw.tech/items/wf-upgrade-regression?lang=zh
- 修订: 2
- 发布日期: 2026-10-01T13:51:23.773Z
- 复核日期: 2026-10-01T00:00:00.000Z
- 内容更新: 2026-10-01T13:51:29.241Z
- 复核状态: current; 0 条来源变化待复核
- 适用版本: 未锁定；请核对当前文档

升级有用的前提是原有任务仍能工作。前后使用同一无害输入，分别检查安装包和 gateway 实际运行版本；重启失败时两者可能不同。

## 准备对照

1. 记录 CLI 版本、运行 gateway 身份、发布渠道和配置路径，共享记录不含密钥。
2. 阅读与启用渠道和工具有关的发行说明，变更前创建并核验备份。
3. 运行五个小基线：文字回复、只读文件访问、新会话记忆、私人测试渠道回复和一次无害定时事件。
4. 按安装方式对应的更新流程执行，检查完成情况和 gateway 实际运行版本，再重复同一组检查。

## 验收

在各环节对照输出，不只看更新器退出码。原来通过的任务失败时，保留前后版本、错误证据和恢复文件。暂停受影响的周期任务，避免反复处理不完整输出。


## 恢复与清理

使用与已记录安装方式对应的官方恢复方法。基线通过且目标数据完整前，不删除迁移原件或备份。仅恢复代码未必能撤销状态迁移。


## 证据与限制

- official_documentation
- 依据所列官方文档编写的 BotClaw 验收方法。未运行产品命令，请核对自己的安装版本。

## 来源

- https://docs.openclaw.ai/install/updating
- https://docs.openclaw.ai/cli/backup