2026年OpenClaw最新升级指南:官方命令+踩坑实录

目录

• 升级前先备份，以防万一
• 升级方法一：一条命令搞定（推荐）
• 升级方法二：源码 / Git 方式
• 升级方法三：全局 npm 升级
• 升级完成后，建议做以下 4 步
• 我踩过的坑：飞书插件离奇失踪
• 经验总结

今天升级 OpenClaw 的时候，翻车了。gateway启动竟然报错了——飞书插件路径找不到了

下面把我踩的坑和官方推荐的升级方法一起整理出来，保证你升级不翻车。

备份整个 .openclaw 文件夹快照

cp -r ~/.openclaw ~/.openclaw.bak

最简单的方式，直接跑官方安装脚本：

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

它会：

• 自动检测你现有的安装
• 执行原地升级
• 在需要时帮你跑 openclaw doctor

上面的命令默认会触发新手引导。如果你不想再走一遍向导，加个no-onboard参数：

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

如果你用的是 Git 安装：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard

特点：

• 使用 git pull --rebase 更新（前提是仓库干净）
• 不触发新手向导
• 你的现有配置纹丝不动

之前用 npm 全局安装的：

npm install -g openclaw@latest

升级完不等于完事，官方建议跑完这套组合拳：

1. 检查配置（并自动修复）

openclaw doctor --fix

2. 重启 Gateway

openclaw gateway restart

3. 检查插件状态

openclaw plugins list

4. 更新所有插件到最新（可选）

openclaw plugins update --all

说说我这次升级遇到的问题。

问题原因：

早些时候安装的飞书插件不是用官方openclaw plugins install安装的

所以路径没在extensions里，升级时就没了

官方安装插件路径统一在~/.openclaw/extensions

解决方案：

第一步：把配置文件 ~/.openclaw/openclaw.json 里那个不存在的飞书路径设置为空：

"load": {
  "paths": [
    ""
 ]

第二步：启动 Gateway

openclaw gateway start

第三步：重新安装飞书插件（这次用官方方式）

openclaw plugins install @openclaw/feishu

第四步：再次重启

openclaw gateway restart

一顿操作之后，飞书终于活过来了。

• 插件要用官方方式装：openclaw plugins install，别野路子
• 升级后必跑 doctor：它会帮你检查配置和迁移问题
• 升级前最好备份：配置文件、凭证、工作区都备份一下

到此这篇关于OpenClaw最新升级指南:官方命令+踩坑实录的文章就介绍到这了,更多相关OpenClaw升级内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！