能用就别动!升级openclaw 3.12~3.24有坑【哭】

尤其是在入门级2G内存服务器上安装openclaw的同学一定留意了：

根据最近的社区反馈，OpenClaw 近期几个版本（特别是 v2026.3.22 和 v2026.3.23）存在严重回归问题，导致大量用户需要降级到 v2026.3.13 或 v2026.3.11 等稳定版本。

近期需降级的版本问题汇总

版本	严重问题	推荐降级目标
v2026.3.24	内存泄漏（JavaScript OOM导致gateway拉起不正常）	v2026.3.11
v2026.3.23	Telegram 通道显示"not configured"错误，无法启动（配置实际有效）	v2026.3.13
v2026.3.22	WhatsApp 通道完全失效、Control UI 前端资源缺失（503错误）	v2026.3.13 / v2026.3.11
v2026.3.12	内存泄漏（OOM导致CLI完全不可用）、Anthropic模型别名崩溃	v2026.3.11

在发布3.24后，本以为前几个版本的问题解决了，在macStudio上升级也正常，就选择把腾讯云上的龙虾也升级了，结果就遇到了OOM问题（如下图），导致gateway启动异常。连openclaw doctor都跑不起来。

我估计这个问题在低内存硬件上会更容易发生。

翻车后怎么办？降级吧

1. 备份当前配置（关键）

# 备份配置和状态cp ~/.openclaw/config.json ~/.openclaw/config.json.bakopenclaw backup create --all  # 如CLI仍能运行

2. 执行降级

NPM 全局安装方式（最常见）：

# 卸载当前问题版本npm uninstall -g openclaw# 安装稳定版本（v2026.3.11 为当前社区验证的最稳版本）npm install -g openclaw@2026.3.11# 验证版本openclaw --version

Docker 方式：修改 docker-compose.yml 中镜像标签为固定版本：

image:openclaw/openclaw:2026.3.11

3. 清理版本残留元数据

降级后如出现"config was written by a newer version"警告，执行：

openclaw config unset meta.lastTouchedVersion

4. 重启服务

openclaw gateway restartopenclaw health  # 验证状态

特殊情况处理

v2026.3.22 UI 缺失临时修复（不想降级时）：如已升级 3.22 且 Dashboard 消失，可从旧版本复制缺失文件：

cd /tmpnpm pack openclaw@2026.3.11tar -xzf openclaw-2026.3.11.tgzcp -r package/dist/control-ui $(npm prefix -g)/lib/node_modules/openclaw/dist/openclaw gateway restart

模型降级（Fallback）配置：如遇到 API 配额问题而非软件 Bug，可在配置中设置自动降级模型：

{"on_budget_exceeded":"downgrade_model","fallback_behavior":{"action":"downgrade_model","target":"gpt-4o-mini","notify":true}}

提示：降级不会丢失历史对话和 Agent 配置，但如降级后仍异常，建议清除配置缓存或执行 openclaw doctor --fix 进行配置迁移。