今天升級(jí) OpenClaw 的時(shí)候，翻車了。gateway啟動(dòng)竟然報(bào)錯(cuò)了——飛書插件路徑找不到了

下面把我踩的坑和官方推薦的升級(jí)方法一起整理出來，保證你升級(jí)不翻車。

升級(jí)前先備份，以防萬一

備份整個(gè) .openclaw 文件夾快照

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

升級(jí)方法一：一條命令搞定（推薦）

最簡(jiǎn)單的方式，直接跑官方安裝腳本：

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

它會(huì)：

• 自動(dòng)檢測(cè)你現(xiàn)有的安裝
• 執(zhí)行原地升級(jí)
• 在需要時(shí)幫你跑 openclaw doctor

上面的命令默認(rèn)會(huì)觸發(fā)新手引導(dǎo)。如果你不想再走一遍向?qū)?，加個(gè)no-onboard參數(shù)：

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

升級(jí)方法二：源碼 / Git 方式

如果你用的是 Git 安裝：

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

特點(diǎn)：

• 使用 git pull --rebase 更新（前提是倉庫干凈）
• 不觸發(fā)新手向?qū)?/li>
• 你的現(xiàn)有配置紋絲不動(dòng)

升級(jí)方法三：全局 npm 升級(jí)

之前用 npm 全局安裝的：

npm install -g openclaw@latest

升級(jí)完成后，建議做以下 4 步

升級(jí)完不等于完事，官方建議跑完這套組合拳：

1. 檢查配置（并自動(dòng)修復(fù)）

openclaw doctor --fix

2. 重啟 Gateway

openclaw gateway restart

3. 檢查插件狀態(tài)

openclaw plugins list

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

openclaw plugins update --all

我踩過的坑：飛書插件離奇失蹤

說說我這次升級(jí)遇到的問題。

問題原因：

早些時(shí)候安裝的飛書插件不是用官方openclaw plugins install安裝的

所以路徑?jīng)]在extensions里，升級(jí)時(shí)就沒了

官方安裝插件路徑統(tǒng)一在~/.openclaw/extensions

解決方案：

第一步：把配置文件 ~/.openclaw/openclaw.json 里那個(gè)不存在的飛書路徑設(shè)置為空：

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

第二步：?jiǎn)?dòng) Gateway

openclaw gateway start

第三步：重新安裝飛書插件（這次用官方方式）

openclaw plugins install @openclaw/feishu

第四步：再次重啟

openclaw gateway restart

一頓操作之后，飛書終于活過來了。

經(jīng)驗(yàn)總結(jié)

• 插件要用官方方式裝：openclaw plugins install，別野路子
• 升級(jí)后必跑 doctor：它會(huì)幫你檢查配置和遷移問題
• 升級(jí)前最好備份：配置文件、憑證、工作區(qū)都備份一下

到此這篇關(guān)于OpenClaw最新升級(jí)指南:官方命令+踩坑實(shí)錄的文章就介紹到這了,更多相關(guān)OpenClaw升級(jí)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論