今天升级 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 方式

如果你用的是 Git 安装：

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

特点：

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

---

升级方法三：全局 npm 升级

之前用 npm 全局安装的：

npm install -g openclaw@latest

---

升级完成后，建议做以下 4 步

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

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

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

---

经验总结

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

祝各位升级顺利，不翻车 🚀

---

👉 关注公众号"北灵聊AI"，获取最新更新