OpenClaw 版本更新完整指南

更新时间：2026-03-09 | 作者：DJ| 标签：#OpenClaw #技术文档 #更新指南

---

先说实话，直接使用

openclaw update 

指令最方便，以下为其他几种常用更新方式

一、更新前准备

1.1 确认当前版本

openclaw --version

1.2 备份数据

Linux / macOS

# 备份配置文件
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
​
# 备份凭证目录
cp -r ~/.openclaw/credentials ~/.openclaw/credentials.bak
​
# 备份工作空间
cp -r ~/.openclaw/workspace ~/.openclaw/workspace.bak

Windows PowerShell

# 备份配置文件
copy $env:USERPROFILE\.openclaw\openclaw.json $env:USERPROFILE\.openclaw\openclaw.json.bak
​
# 备份整个 openclaw 目录（谨慎使用）
Copy-Item -Path $env:USERPROFILE\.openclaw -Destination $env:USERPROFILE\.openclaw.bak -Recurse

⚠️ 注意：Windows 备份整个目录可能会占用较多空间，建议只备份配置文件和工作空间

---

二、更新方式

方式一：重新运行安装程序（最推荐）

Linux / macOS

# 标准安装
curl -fsSL https://openclaw.ai/install.sh | bash
​
# 跳过向导
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

---

方式二：npm / pnpm 更新

# 更新到最新稳定版
npm i -g openclaw@latest
pnpm add -g openclaw@latest
​
# 更新到 beta 版本
npm i -g openclaw@beta
pnpm add -g openclaw@beta
​
# 指定版本更新
npm i -g openclaw@2026.3.2
pnpm add -g openclaw@2026.3.2

💡 提示：使用 npm/pnpm 更新时，会保留现有的配置文件，更新更安全

---

方式三：内置命令更新

# 检查更新状态
openclaw update status
​
# 预览更新（不实际执行）
openclaw update --dry-run
​
# 更新到最新版本
openclaw update
​
# 切换到 beta 渠道
openclaw update --channel beta
​
# 指定版本更新
openclaw update --tag 2026.3.2

---

方式四：Docker 更新

# 1. 拉取最新镜像
docker pull ghcr.io/openclaw/openclaw:latest
​
# 2. 停止并删除旧容器
docker stop openclaw
docker rm openclaw
​
# 3. 启动新容器（使用旧配置）
docker run -d --name openclaw \
  -p 8080:8080 \
  -v ~/.openclaw:/home/node/.openclaw \
  ghcr.io/openclaw/openclaw:latest

🐳 提示：Docker 方式适合容器化部署，推荐用于生产环境

---

方式五：源码更新

# 1. 克隆仓库
cd ~/openclaw
git pull origin main

# 2. 安装依赖
pnpm install

# 3. 构建项目
pnpm build

# 4. 构建前端 UI
pnpm ui:build

# 5. 全局链接
npm link

⚠️ 注意：源码更新需要 Node.js 环境，适合开发者使用

---

三、更新后操作

3.1 健康检查

# 运行健康检查
openclaw doctor

# 重启网关
openclaw gateway restart

# 检查网关状态
openclaw gateway status

# 检查整体状态
openclaw status

---

3.2 验证功能

# 列出可用模型
openclaw models list

# 列出已安装技能
openclaw skills list

# 查看最近 50 条日志
openclaw logs --tail 50

---

四、常见问题处理

4.1 UI 无法访问

# 1. 确保 Gateway 绑定在 LAN
openclaw config set gateway.bind lan

# 2. 允许不安全的认证
openclaw config set gateway.controlUi.allowInsecureAuth true

# 3. 禁用设备认证（仅用于开发环境）
openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true

# 4. 重启 Gateway
openclaw gateway restart

---

4.2 技能不工作

# 1. 重新加载技能
openclaw skill reload

# 2. 重启 Gateway
openclaw gateway restart

---

4.3 报错 "Unrecognized key"

# 运行诊断并自动修复
openclaw doctor --fix

---

4.4 端口被占用

Linux / macOS

# 查看端口占用
lsof -i :18789

# 强制终止进程
kill -9 <PID>

Windows

# 查看端口占用
netstat -ano | findstr "18789"

# 强制终止进程
taskkill /F /PID <PID>

# 重启 Gateway
openclaw gateway restart

---

五、回滚到旧版本

5.1 从备份恢复

# 1. 停止 Gateway
openclaw gateway stop

# 2. 恢复配置文件
cp ~/.openclaw/openclaw.json.bak ~/.openclaw/openclaw.json

# 3. 安装旧版本
npm i -g openclaw@<旧版本号>

# 4. 启动 Gateway
openclaw gateway start

---

5.2 Docker 回滚

# 1. 编辑 docker-compose.yml，改回旧版本 tag
# 2. 重新启动
docker-compose up -d openclaw

---

六、总结

1. 推荐更新方式：openclaw update 内置命令（最简单）

2. 备份很重要：更新前务必备份数据

3. 遇到问题：先运行 openclaw doctor --fix

4. 生产环境：建议使用 Docker 方式部署

参考资料：

• OpenClaw 官方文档

• OpenClaw GitHub

• OpenClaw 社区 Discord