OpenClaw v2026.4.22 升级全记录：从v2026.3.20到v2026.4.22的完整过程

升级概述

本记录详细描述了OpenClaw AI助手从v2026.3.20-beta.6版本升级至v2026.4.22版本的完整过程，包括版本对比、升级步骤及关键技术细节。

升级前环境

• 运行时版本：OpenClaw v2026.3.20-beta.6（WeCom通道）
• 基础镜像版本：OpenClaw 2026.3.13（Docker镜像内置）
• 全局npm包版本：OpenClaw 2026.4.12
• 运行环境：容器化部署（Docker）
• Node.js版本：v24.14.0
• 操作系统：Linux（openEuler 6.6.63内核）

升级步骤

第一步：版本检测

首先通过 OpenClaw status 和 npm ls -g openclaw 命令检测当前版本状态，确认全局npm包的版本和运行时版本之间的差异。

在容器环境部署中，/usr/local/bin/openclaw 软链接指向 /app/openclaw.mjs（旧版Docker镜像内置），而 /home/node/.local/lib/node_modules/openclaw/ 中的全局包则可以通过npm更新。

第二步：执行升级

运行以下命令执行升级：

npm update -g openclaw

升级过程更新了14个包、移除了283个旧包、变更了317个包，共耗时约55秒。

第三步：版本验证

升级后通过 npm ls -g openclaw --depth=0 确认全局包版本已更新至 OpenClaw 2026.4.22。

第四步：重启服务

执行 openclaw gateway restart 重启网关服务以加载新版本。在容器环境中，由于系统软链接指向旧版Docker镜像内的 /app/openclaw.mjs，重启后运行时版本显示为旧版本，但全局npm包已成功更新。

版本变化分析

容器环境升级的注意事项

本次升级过程中遇到的关键技术要点：

1. 双版本共存现象：容器环境下，Docker镜像构建时固定的版本（/app/）和npm全局安装的版本（.local/）共存，软链接指向镜像内置版本。
2. 升级生效条件：要使新版本完全生效，需要同步更新Docker镜像中 /app/ 目录下的文件，或者通过配置让系统直接使用 /home/node/.local/lib/node_modules/openclaw/openclaw.mjs。
3. 全局包可用性：即使运行时显示的是旧版本，新版本的全局npm包仍然可用，可以通过直接调用新路径执行新版本功能。

版本特性与更新建议

OpenClaw 2026.4.22 版本包含了从2026.4.12以来的多项改进和修复。建议在下次容器重建或Docker镜像升级时，同步更新基础镜像到最新版本，以体验完整的版本特性。

总结

本次升级顺利完成npm全局包的版本更新。对于容器化部署环境，升级npm全局包是一种快速获取新版本功能的方式，但完整的版本更新还需要配合Docker镜像的更新。建议将OpenClaw的容器镜像更新纳入常规维护计划中。