官方参考文档：https://docs.openclaw.ai/zh-CN/install/updating

OpenClaw 发展迅速更新频繁，定期发布新版本以引入新功能、改进性能和修复已知问题。为了确保你能够享受到最新的功能和最佳的使用体验，建议定期更新 OpenClaw。

更新前的准备工作

在进行更新之前，请务必确认以下信息并做好备份：

• 配置文件：~/.openclaw/openclaw.json
• 凭证信息：~/.openclaw/credentials/
• 工作区数据：~/.openclaw/workspace

推荐更新方式：重新运行安装程序（原地升级）

这是最简单且首选的更新路径。安装程序会自动检测现有安装、执行原地升级，并在需要时运行 openclaw doctor 进行健康检查。

curl -fsSL https://openclaw.ai/install.sh | bash

说明：

• 如果你不想再次运行新手引导向导，可以添加 --no-onboard 参数。
• 对于全局安装的用户，该脚本底层会自动执行 npm install -g openclaw@latest。

安装更新完成之后，会自动进入引导界面，进行相关的配置，也可以跳过。

◇  Tighten permissions on ~/.openclaw to 700?
│  Yes

◇  Enable systemd lingering for lckfb?
│  Yes

◇  Enable bash shell completion for openclaw?
│  Yes

◇  Restart gateway service now?
│  Yes

全局安装更新 (npm/pnpm)

如果你是通过 npm 或 pnpm 全局安装的，可以直接运行以下命令之一：

# 使用 npm
npm i -g openclaw@latest

# 或者使用 pnpm
pnpm add -g openclaw@latest

更新完成后，请务必运行以下命令检查状态并重启网关：

openclaw doctor
openclaw gateway restart
openclaw health

AI更新方式

我们可以给OpenClaw说：“ OpenClaw帮我更新到最新版本 ”，OpenClaw会自动帮我们完成更新的操作。

常见问题

use HTTPS or localhost secure context 或 UI界面无法访问或者显示不正常

因为在新版本的OpenClaw中更新了相关的设置，重新配置即可：

# 1. 设定网络访问模式为 LAN
openclaw config set gateway.bind lan

# 2. 设定HTTP访问降级为 true，允许不安全的HTTP访问（如果不设置这个参数，默认是禁止HTTP访问的）
openclaw config set gateway.controlUi.allowInsecureAuth true
openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true
openclaw config set gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback true

# 3. 重启 OpenClaw gateway 使配置生效
openclaw gateway restart