OpenClaw 提供三种更新方式：内置 openclaw update 命令（最简单，一条命令完成）、npm 全局包手动更新（适合需要指定版本的场景）、Git 源码拉取（适合开发者或需要 dev 渠道的用户）。OpenClaw 同时维护三个发布渠道：stable（正式版）、beta（公测版）、dev（主干最新）。无论哪种方式，更新前停止 Gateway + 备份配置、更新后运行 openclaw doctor 是保证更新顺利完成的两个关键步骤。

 

三种更新方式速查

方式

适用人群

命令

能否指定版本

openclaw update 内置命令

所有用户（推荐）

openclaw update --channel stable

❌（只能切换渠道）

npm 手动更新

需要指定版本 / 回滚

npm install -g openclaw@版本号

✅

Git 源码更新

开发者 / dev 渠道用户

git pull && npm install

✅（指定 commit）

 

方式 1：内置 openclaw update 命令（推荐）

OpenClaw CLI 内置了 update 子命令，可自动检测并安装指定渠道的最新版本。

基础更新流程

 

# Step 1：停止 Gateway（避免更新过程中文件被占用）
openclaw gateway stop
 
# Step 2：执行更新（更新到 stable 最新版）
openclaw update --channel stable
 
# Step 3：重启 Gateway
openclaw gateway start
 
# Step 4：验证更新结果
openclaw --version
openclaw doctor

三个发布渠道

渠道

npm 标签

说明

适合人群

stable

latest

经完整测试的正式版本，命名格式 vYYYY.M.D

大多数用户（推荐）

beta

beta

预发布测试版，命名格式 vYYYY.M.D-beta.N

想体验新功能的用户

dev

dev

main 分支最新代码，每次提交触发发布

开发者 / 贡献者

切换到 beta 渠道：

 

openclaw update --channel beta

切换回 stable 渠道：

 

openclaw update --channel stable

注意：从 beta / dev 降回 stable 实际上是版本降级，openclaw update --channel stable 会自动处理，但建议先备份 ~/.openclaw/ 目录。

 

方式 2：npm 手动更新（可指定版本）

通过 npm 直接管理版本，适合需要锁定特定版本或回滚的场景。

更新到最新 stable 版

 

openclaw gateway stop
npm install -g openclaw@latest
openclaw gateway start
openclaw --version

更新到指定版本

 

# 查看所有可用版本（显示最近 20 个）
npm view openclaw versions --json | python3 -c \
  "import sys,json; v=json.load(sys.stdin); print('\n'.join(v[-20:]))"
 
# 安装指定版本（以 2026.3.13-1 为例）
openclaw gateway stop
npm install -g openclaw@2026.3.13-1
openclaw gateway start
openclaw --version

安装 beta 版本

 

npm install -g openclaw@beta

当前各渠道最新版本（截至 2026 年 3 月 15 日）

渠道

最新版本

发布日期

主要变更

stable

v2026.3.13-1

2026-03-14

修复 v2026.3.13 断开的 tag，修复会话保留、Telegram 媒体传输

beta

v2026.3.13-beta.1

2026-03-14

Android 聊天设置重设计、iOS 引导页改版

stable（次新）

v2026.3.12

2026-03-13

Control UI 仪表盘刷新、GPT-5.4 fast mode 配置

⚠️ 已知问题：v2026.3.12 存在多个 regression（ANTHROPIC_MODEL_ALIASES 初始化崩溃、CLI 握手超时），v2026.3.13 存在 @lancedb 依赖丢失问题。推荐使用 v2026.3.13-1（已修复上述问题）或 v2026.3.11。

 

方式 3：Git 源码更新（开发者）

从源码构建的用户通过 git pull 获取最新代码。

 

# 进入源码目录
cd ~/openclaw  # 替换为实际克隆路径
 
# 停止 Gateway
openclaw gateway stop
 
# 拉取最新代码（stable 分支）
git fetch origin
git checkout main
git pull origin main
 
# 安装/更新依赖
npm install
 
# 重新构建
npm run build
 
# 重启 Gateway
openclaw gateway start
 
# 验证
openclaw --version

若要跟踪特定 commit：

 

# 查看最近提交记录
git log --oneline -20
 
# 切换到指定 commit
git checkout <commit-hash>
npm install && npm run build

更新前必做：备份配置

更新前备份关键配置文件，防止更新失败后配置丢失：

 

# 一键备份整个 .openclaw 目录
cp -r ~/.openclaw ~/.openclaw.backup-$(date +%Y%m%d)
 
# 重点文件：
# ~/.openclaw/agents/main/agent/auth-profiles.json — API Key 配置
# ~/.openclaw/agents/main/skills/                   — 已安装技能
# ~/.openclaw/config.yaml                           — 全局配置

若更新失败需要恢复：

 

# 恢复备份
rm -rf ~/.openclaw
cp -r ~/.openclaw.backup-20260315 ~/.openclaw

更新后验证：openclaw doctor

更新完成后，官方推荐运行 openclaw doctor 进行全面健康检查：

 

openclaw doctor

openclaw doctor 检查项包括：

● Gateway 守护进程是否正常运行

● 端口 18789 是否正常监听

● auth-profiles.json 格式是否合法

● API Key 是否可连通

● 技能目录权限是否正确

● Node.js 版本是否满足要求（≥22）

若 doctor 输出有红色错误项，参照错误信息修复后再重试。

 

Docker 更新方式

使用 Docker 部署的用户：

 

# 拉取最新镜像
docker pull openclaw/openclaw:latest
 
# 停止并删除旧容器
docker stop openclaw && docker rm openclaw
 
# 用新镜像重新启动（保持原有 volume 挂载）
docker run -d \
  --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  openclaw/openclaw:latest
 
# 验证版本
docker exec openclaw openclaw --version

锁定到特定版本（替换 latest 为版本号）：

 

docker pull openclaw/openclaw:2026.3.13-1

常见问题

Q：openclaw update 和 npm install -g openclaw@latest 有什么区别？

openclaw update 是官方内置命令，除更新 npm 包外，还会同步更新 Gateway 守护进程注册文件（launchd/systemd）和内置技能资产；npm install -g 只更新可执行文件，不处理守护进程层面的变更。推荐优先使用 openclaw update。

Q：怎么知道当前用的是哪个渠道？

运行 openclaw config get updateChannel 查看当前渠道设置。若未显示，默认为 stable。

Q：更新后发现新版本有 bug，如何快速回滚？

 

openclaw gateway stop
npm install -g openclaw@2026.3.11  # 替换为目标版本
openclaw gateway start
openclaw --version

回滚不影响 ~/.openclaw/ 中的配置和数据。

Q：macOS 上 openclaw update 报权限错误怎么解决？

这是 npm 全局目录权限问题。运行 sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} 修复权限后重试，或将 npm 全局目录改到用户目录（npm config set prefix ~/.npm-global）。

Q：不想关注版本更新，有没有更省心的方案？

Linclaw（七牛云推出的 OpenClaw 桌面版）通过 macOS DMG / Windows EXE 标准安装包分发，应用内置自动更新检测，有新版本时直接提示下载覆盖安装，无需手动执行任何命令，适合不想操作命令行的用户。

总结

OpenClaw 更新推荐使用内置 openclaw update --channel stable 命令，执行前停止 Gateway、备份 ~/.openclaw/，执行后运行 openclaw doctor 验证。需要锁定版本时改用 npm install -g openclaw@版本号。截至 2026 年 3 月，推荐版本为 v2026.3.13-1（修复了 v2026.3.12/13 的 regression）；若使用国内模型或追求稳定，也可锁定 v2026.3.11。

本文内容基于 2026 年 3 月 OpenClaw 官方 GitHub Release 页面整理，版本信息随官方迭代持续更新，建议以 npm view openclaw versions 查询实时可用版本。

延伸资源

● OpenClaw GitHub Releases：https://github.com/openclaw/openclaw/releases

● Linclaw 官网（内置自动更新，无命令行操作）