OpenClaw升级需根据安装方式选择对应方法：命令行一键更新、安装脚本就地升级、Web界面更新、Docker容器内升级、Git源码升级，或通道/版本定向切换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 OpenClaw，但当前运行版本低于最新稳定版（如 v2026.3.2），则需执行版本升级以获取功能增强与安全修复。以下是多种兼容不同安装方式的升级操作方法：
一、命令行一键更新（推荐通用方式）
该方法适用于通过 npm/pnpm 全局安装或官方脚本安装的用户，自动完成版本拉取、依赖检查与服务重启。
1、执行标准更新命令：
openclaw update
2、等待命令输出完成，并确认终端显示新版本号（例如：v2026.3.2）
3、重启 Gateway 服务以加载新版逻辑：
openclaw gateway restart
4、验证服务健康状态：
openclaw health
二、使用安装脚本就地升级
该方式优先检测现有环境，自动适配路径与配置，避免手动迁移风险，特别适合从早期版本（如 v2026.1.x 或 v2026.2.x）升级的用户。
1、运行通用升级脚本：
curl -fsSL https://openclaw.bot/install.sh | bash
2、若跳过引导流程（如已配置完整），添加 --no-onboard 参数：
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --no-onboard
3、源码安装用户需显式指定安装方式：
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --install-method git --no-onboard
4、升级完成后立即执行环境诊断：
openclaw doctor
三、Web 管理界面一键更新
该方式无需接触命令行，适用于通过 Lighthouse 控制台、1Panel 或 Docker 镜像部署且已启用 Web UI 的用户，所有操作在浏览器中完成。
1、访问 OpenClaw Web 管理界面：
http://您的服务器IP:3000
2、登录后进入「系统设置」或「关于」页面
3、查找并点击「一键更新」按钮
4、等待界面提示“更新完成”，随后手动刷新页面确认版本号变更
四、Docker 容器内升级（需 root 权限）
容器内默认以非 root 用户运行，直接执行 openclaw update 会因权限不足失败；必须切换至 root 用户上下文才能修改全局 node_modules。
1、以 root 身份进入容器：
docker exec -it --user root openclaw sh
把客户发来的各种格式的排产/计划/需求 Excel（横向表、T+2 真单、滚动计划、物料到货计划、生产计划下发表等， 格式五花八门、中英文混杂、单/多 sheet）自动识别归类到三个标准模板之一，熔解内容并填充成统一模板， 再与库中旧版本逐单元格比对、标注更新之处。Use when 用户上传一个或多个 Excel...
2、在容器内执行更新：
openclaw update
3、退出容器后重启服务：
docker restart openclaw
4、检查日志确认启动成功：
docker logs openclaw --tail 10
五、Git 源码方式升级
适用于通过 git clone 获取代码并本地构建的开发者，可精确控制分支、标签与通道，支持 beta/dev/stable 多通道切换。
1、切换至 OpenClaw 项目根目录：
cd /path/to/openclaw
2、拉取最新变更并重建：
git pull --rebase && pnpm install && pnpm build && pnpm ui:build
3、执行配置与数据迁移检查：
pnpm openclaw doctor
4、如提示配置不兼容，执行自动修复：
pnpm openclaw doctor --fix
5、启动开发模式网关验证：
pnpm gateway:watch
六、通道与版本定向切换
当需要测试预发布功能或回退至特定稳定版本时，可通过 channel 与 tag 参数精准控制更新目标。
1、切换至 beta 更新通道：
openclaw update --channel beta
2、切换至 dev 通道（每日构建）：
openclaw update --channel dev
3、强制回退至 stable 通道：
openclaw update --channel stable
4、安装指定版本标签（如 v2026.2.9）：
openclaw update --tag v2026.2.9
5、预览更新内容（不实际执行）：
openclaw update --dry-run
6、跳过交互确认（适合自动化脚本）：
openclaw update --yes
7、仅更新文件不重启服务：
openclaw update --no-restart
