fnOS OpenClaw Updater
/install fnos-openclaw-updater
飞牛 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@\x3C最新版本>
# 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@\x3C最新版本>
等待 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 |
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install fnos-openclaw-updater - After installation, invoke the skill by name or use
/fnos-openclaw-updater - Provide required inputs per the skill's parameter spec and get structured output
What is fnOS OpenClaw Updater?
飞牛 OpenClaw 更新助手。触发词:「更新openclaw」「升级openclaw」。功能:检测当前运行的 openclaw 版本 → 查找最新稳定版本 → 在 managed-install 目录内执行 npm install 覆盖更新 → 自动重启网关生效。 It is an AI Agent Skill for Claude Code / OpenClaw, with 66 downloads so far.
How do I install fnOS OpenClaw Updater?
Run "/install fnos-openclaw-updater" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is fnOS OpenClaw Updater free?
Yes, fnOS OpenClaw Updater is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does fnOS OpenClaw Updater support?
fnOS OpenClaw Updater is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created fnOS OpenClaw Updater?
It is built and maintained by PandaltsGo (@pandaltsgo); the current version is v1.0.0.