OpenClaw 作为一款跨平台的 AI 网关，持续迭代带来新功能与修复。本文将详细介绍几种更新 OpenClaw 到最新版本的方法，并针对常见问题提供解决方案。

---

为什么需要更新？

• 新功能：新版 OpenClaw 增加技能、插件和配置项
• 安全修复：修复已知漏洞，提升系统安全性
• 性能优化：更快的消息处理和更低的资源占用
• 兼容性：支持最新的大语言模型和第三方服务
• Bug 修复：解决旧版本的稳定性问题

---

更新前准备

1. 备份配置

   Copy

   cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

2. 检查当前版本

   Copy

   openclaw --version
   # 或
   openclaw gateway status

3. 阅读更新日志
   访问 OpenClaw GitHub Releases 查看版本变更。

---

方法一：使用内置更新命令（推荐）

OpenClaw 自带更新工具，一键完成：

Copy

# 检查可用更新
openclaw update check

# 执行更新
openclaw update run

系统会自动检测当前版本，下载最新版并重启网关。

Note：如果提示“permission denied”，说明全局安装需要 root 权限，见方法二。

---

方法二：手动 npm 更新（全局安装）

适用于通过 npm install -g openclaw 全局安装的情况。

正常情况（有 sudo 权限）

Copy

# 直接更新
sudo npm i -g openclaw@latest --no-fund --no-audit

# 更新完成后重启
openclaw gateway restart

常见错误：EACCES 权限拒绝

错误信息类似：

Copy

npm error Error: EACCES: permission denied, rename '/usr/lib/node_modules/openclaw' -> '/usr/lib/node_modules/.openclaw-XXXX'

解决方式 A：使用 sudo（直接）

Copy

sudo npm install -g openclaw@latest
sudo chown -R $(whoami) ~/.npm  # 避免后续 npm 命令也需 sudo

解决方式 B：更改 npm 全局安装目录（避免 sudo）

1. 配置用户级全局目录：

   Copy

   mkdir -p ~/.npm-global
   npm config set prefix '~/.npm-global'

2. 更新 shell 配置文件（~/.bashrc 或 ~/.zshrc）：

   Copy

   echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
   source ~/.bashrc

3. 重新安装 OpenClaw：

   Copy

   npm install -g openclaw

4. 后续更新不再需要 sudo。

---

方法三：使用 nvm（Node 版本管理器）

如果你使用 nvm 管理 Node.js，更新 OpenClaw 很简单：

Copy

# 确保 nvm 已加载
nvm use 22  # 或你使用的 Node 版本

# 更新 OpenClaw
npm install -g openclaw@latest

# 验证
openclaw --version

nvm 安装的包位于用户目录，无需 root。

---

方法四：从源码编译更新

适合需要定制或想使用最新开发版的用户：

Copy

# 1. 克隆或拉取最新源码
cd ~/projects
git clone https://github.com/openclaw/openclaw.git
# 或更新已有仓库
git pull origin main

# 2. 安装依赖并构建
npm install
npm run build

# 3. 链接到全局（可选）
npm link  # 创建 openclaw 命令软链接

# 4. 重启网关
openclaw gateway restart

---

方法五：Docker 更新

如果使用 Docker 运行 OpenClaw：

Copy

# 拉取最新镜像
docker pull openclaw/openclaw:latest

# 停止旧容器
docker stop openclaw-gateway
docker rm openclaw-gateway

# 运行新容器
docker run -d \
  --name openclaw-gateway \
  -p 18789:18789 \
  -v ~/.openclaw:/home/node/.openclaw \
  openclaw/openclaw:latest

注意容器内路径映射。

---

更新后验证

1. 检查服务状态

   Copy

   openclaw gateway status

2. 查看版本

   Copy

   openclaw --version

3. 访问 Web UI
   打开浏览器访问 http://localhost:18789，确认控制面板正常。

4. 测试通道
   如果有飞书、Telegram 等配置，发送一条消息测试是否正常。

---

常见问题处理

1. 更新后服务无法启动

• 端口占用：netstat -tulpn | grep 18789 检查并停止占用进程。
• 配置不兼容：恢复备份配置，逐步迁移新设置。
• 权限问题：检查 ~/.openclaw/ 目录所有权：sudo chown -R $(whoami) ~/.openclaw

2. 插件/技能丢失

某些插件可能在更新中被移除或改名，确认 plugins.entries 配置，并运行：

Copy

openclaw plugins list

3. 数据库迁移

如果更新涉及数据库 schema 变更，OpenClaw 通常会自动迁移。若失败，查看日志：

Copy

openclaw logs --tail 100

---

最佳实践建议

1. 定期更新：订阅 GitHub releases 或设置每月检查一次。
2. 测试环境先行：先在非生产环境更新验证，再应用到主力系统。
3. 记录变更：将更新前后的配置差异归档，便于问题排查。
4. 使用版本锁定：如需稳定性，可指定版本：npm install -g openclaw@2026.3.24。

---

总结

更新 OpenClaw 有多种方式，选择适合自己的即可：

• 普通用户：用 openclaw update run 或 npm i -g openclaw@latest
• 无 sudo 权限：改用 nvm 或修改 npm prefix
• 高级用户：从源码构建，获取最新功能

更新前备份配置，更新后验证功能，保持系统最新且稳定。

---

延伸阅读：

• OpenClaw 官方文档
• GitHub 仓库
• 社区 Discord