飞牛 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：

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

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

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

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

更新流程（按顺序执行）

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

openclaw --version
npm view openclaw version

比较两者：

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

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

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

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

Step 3：验证更新成功

openclaw --version

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

注意事项

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

常见问题