飞牛 OpenClaw 更新助手#

关键原则#

OpenClaw 安装在 managed-install 目录，即 $OPENCLAW_DATA_DIR/openclaw（飞牛系统标准路径，普通用户无权限写 /vol1/@appcenter/ 系统层）。

路径公式： {OPENCLAW_DATA_DIR}/openclaw 每个飞牛系统的 OPENCLAW_DATA_DIR 不同，但 managed-install 结构一致。 不要硬编码 /vol1/@apphome/... 路径，动态获取更安全。

不要 用 npm i -g openclaw（会报 EACCES 权限错误），也 不要 用 openclaw update（同样是全局安装路径）。

正确更新方式#

在 managed-install 目录内直接 npm install：

bash

# 1. 查询当前运行版本
openclaw --version

# 2. 查询最新版本
npm view openclaw version

# 3. 在 managed-install 目录内更新（会覆盖旧版本，自动生效）
cd "$OPENCLAW_DATA_DIR/openclaw" && npm install openclaw@<最新版本>

# 4. 等待几秒让进程重新加载

更新流程（按顺序执行）#

Step 1：确认当前版本和最新版本#

bash

openclaw --version
npm view openclaw version

比较两者：

• 如果 openclaw --version >= npm view openclaw version，已是最新的，无需操作
• 否则继续 Step 2

Step 2：在 managed-install 目录内安装#

bash

cd "$OPENCLAW_DATA_DIR/openclaw" && npm install openclaw@<最新版本>

等待 npm 完成（通常 1-2 分钟）。

Step 3：验证更新成功#

bash

openclaw --version

确认输出为新版本号。网关会自动在新版本下运行。

注意事项#

• 不要 使用 sudo、 npm i -g、 openclaw update——这些都会失败
• 更新是覆盖安装，无需卸载
• 网关进程会自动在新版本下运行，无需手动重启（除非有异常）
• 遇到 EBADENGINE 警告（undici / node 版本提示）可以忽略，不影响更新

常见问题#

症状原因解决EACCES permission denied用了全局安装改用 managed-install 目录内 npm install更新后版本没变进程缓存了旧路径等几秒再查，或确认 openclaw 路径指向正确目录npm 下载慢网络问题可以给 npm 设置镜像： npm config set registry https://registry.npmmirror.com