fnOS OpenClaw 更新器

飞牛 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 版本提示）可以忽略，不影响更新

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