概述

很多人在使用openclaw的时候，会遇到升级问题，各种升级不成功，折腾半天，现在告诉你一个简单高效的方式：打开TRAE，进入SOLO，给它发个指令：根据“OpenClaw 升级指导”进行openclaw的升级。

本文档详细介绍如何高效、安全地升级 OpenClaw，规避常见问题，确保升级成功率。

升级前检查

1. 检查当前版本

openclaw --version

示例输出：

OpenClaw 2026.4.9 (0512059)

2. 检查更新状态

openclaw update status

示例输出：

OpenClaw update status

┌──────────┬─────────────────────────────────────────────────────────────────────┐
│ Item     │ Value                                                               │
├──────────┼─────────────────────────────────────────────────────────────────────┤
│ Install  │ pnpm                                                                │
│ Channel  │ stable (default)                                                    │
│ Update   │ available · pnpm · npm update 2026.4.15                             │
└──────────┴─────────────────────────────────────────────────────────────────────┘
Update available (npm 2026.4.15). Run: openclaw update

升级步骤（推荐）

⭐ 方案一：使用国内镜像源升级（推荐，成功率高）

这是最稳定、最快速的升级方式，特别适合中国大陆用户。

npm update -g openclaw --registry=https://registry.npmmirror.com

优点：

• 速度快（国内镜像源）

• 成功率高（无需连接 GitHub）

• 稳定可靠

方案二：使用 OpenClaw 内置升级命令

注意： 此方式可能因网络问题失败（无法连接 GitHub）

openclaw update --yes

常见错误：

npm error fatal: unable to access 'https://github.com/whiskeysockets/libsignal-node.git/': 
Failed to connect to github.com port 443 after 21042 ms: Could not connect to server

如果遇到此错误，请立即切换到方案一。

验证升级

1. 检查新版本

openclaw --version

成功升级示例：

OpenClaw 2026.4.15 (041266a)

2. 运行健康检查

openclaw doctor

Doctor 会检查：

• 更新状态

• 插件依赖

• 状态完整性

• 安全性

• Skills 状态

• Gateway 状态

如果 Doctor 提示需要修复：

openclaw doctor --fix

常见问题及解决方案

问题 1：无法连接 GitHub

症状：

npm error fatal: unable to access 'https://github.com/...': 
Failed to connect to github.com port 443

解决方案：使用国内镜像源升级（方案一）：

npm update -g openclaw --registry=https://registry.npmmirror.com

问题 2：权限不足

症状：

npm ERR! Error: EACCES: permission denied

解决方案（Windows）：以管理员身份运行 PowerShell 或命令提示符

解决方案（Linux/Mac）：

sudo npm update -g openclaw --registry=https://registry.npmmirror.com

问题 3：升级后 Gateway 无法启动

解决方案：

openclaw doctor --fix

或者手动重启 Gateway：

openclaw gateway restart

问题 4：PowerShell 显示 PSReadLine 错误

症状：

System.ArgumentOutOfRangeException: 该值必须大于或等于零...

说明： 这是 PowerShell 的显示问题，不影响实际升级。升级仍在后台进行，等待完成即可。

升级后操作

1. 验证功能正常

openclaw status

2. 检查插件

openclaw plugins list

3. 测试 Gateway 连接

openclaw health

版本历史参考

快速参考命令

# 检查版本
openclaw --version

# 检查更新
openclaw update status

# ⭐ 推荐升级方式
npm update -g openclaw --registry=https://registry.npmmirror.com

# 健康检查
openclaw doctor

# 修复问题
openclaw doctor --fix

注意事项

1. 始终使用国内镜像源 – 避免 GitHub 连接问题

2. 升级前备份配置 – 可选：备份 ~/.openclaw 目录

3. 升级后运行 doctor – 确保一切正常

4. 关注版本更新 – 定期检查新版本

官方文档

• OpenClaw CLI 文档：https://docs.openclaw.ai/cli

• 更新文档：https://docs.openclaw.ai/cli/update