飞牛 NAS OpenClaw 版本升级指南（3.13 → 4.11）
适用对象：飞牛 fnOS 应用商店安装的 OpenClaw
前置条件：理解飞牛沙盒环境的限制
📌 背景说明
最近帮朋友解决了飞牛 NAS 上 OpenClaw 的升级问题，整理了一份完整方案，分享给有需要的朋友。
先说结论：飞牛应用商店安装的 OpenClaw 与官方 npm 安装方式完全不兼容，系统内的升级按钮无法使用，需要在用户权限可写的目录下完成操作。
🔍 问题类型
你可能遇到以下两种情况：
| 情况 |
表现 |
需要做什么 |
| 情况 A |
直接从飞牛安装，还没升级过 |
需要完整升级 Gateway |
| 情况 B |
已经手动升级过 Gateway，但 UI 显示旧版本 |
只需要修复显示问题 |
⚠️ 重要前提：理解环境限制
飞牛封装的 OpenClaw 运行在专属应用沙盒中，与标准环境不兼容：
| 限制项 |
说明 |
| 系统升级按钮无效 |
Web 界面内的升级按钮点击无反应 |
| 禁止使用 npm install |
这会破坏封装环境，导致应用无法使用 |
| 用户目录可写 |
只有 /vol1/@apphome/<你的用户名>/data/ 目录可写 |
| 系统目录只读 |
/usr/lib/node_modules/ 等是只读挂载 |
🤝 升级方式选择
方式一：交给 OpenClaw 助手升级（推荐 ⭐）
不想自己敲命令？直接把这份指南发给 OpenClaw 助手，发送消息：
"帮我按这个指南升级 OpenClaw"
助手会一步步引导你完成升级，遇到问题会帮你处理。
方式二：自己手动执行
有命令行经验？想自己动手？
操作步骤：
第一步：检查当前版本
# 查看当前 CLI 版本
openclaw --version
# 查看官方最新版本
# 访问 https://www.npmjs.com/package/openclaw 查看
第二步：完整备份（必须！）
# 1. 备份配置文件
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$(date +%Y%m%d)
# 2. 备份用户数据目录
cp -r /vol1/@apphome/<你的用户名>/data/openclaw /vol1/@apphome/<你的用户名>/data/openclaw.backup.$(date +%Y%m%d)
# 3. 备份 bun server 代码
cp /vol1/@appcenter/<你的用户名>/server/index.js /vol1/@appcenter/<你的用户名>/server/index.js.backup.$(date +%Y%m%d)
# 4. 记录当前状态
ps aux | grep openclaw > ~/openclaw_process_backup.txt
ss -tlnp | grep -E "21827|8005" > ~/openclaw_port_backup.txt
提示：把 <你的用户名> 替换成实际的用户名（如 <你的用户名>）
第三步：执行升级
升级原则
| 原则 |
说明 |
| 禁止 npm install |
绝对不能使用，会破坏环境 |
| 在用户目录操作 |
文件操作在 /vol1/@apphome/<你的用户名>/ 下进行 |
| 保持配置不变 |
不修改 API 配置、消息通道等 |
步骤 1：更新用户目录 openclaw CLI
# 创建符号链接指向系统最新版本
rm -rf /vol1/@apphome/<你的用户名>/data/openclaw/node_modules/openclaw
ln -sf /usr/lib/node_modules/openclaw /vol1/@apphome/<你的用户名>/data/openclaw/node_modules/openclaw
步骤 2：更新 bun server 代码版本
找到 /vol1/@appcenter/<你的用户名>/server/index.js，找到约第 2535 行：
var OPENCLAW_VERSION = process.env.OPENCLAW_VERSION || "2026.3.13";
改成最新版本：
var OPENCLAW_VERSION = process.env.OPENCLAW_VERSION || "2026.4.11";
步骤 3：更新 package.json
编辑 /vol1/@apphome/<你的用户名>/data/openclaw/package.json，把版本号改成新版本：
{
"dependencies": {
"openclaw": "2026.4.11"
}
}
步骤 4：重启服务
# 重启 bun server
pkill -f "<你的用户名>/server/index.js"
cd /vol1/@appcenter/<你的用户名>
bun /vol1/@appcenter/<你的用户名>/server/index.js &
# 重启 Gateway
pkill -f "openclaw-gateway"
openclaw gateway start
# 等待 10 秒
sleep 10
步骤 5：清除浏览器缓存
- Chrome/Edge：
Ctrl + Shift + Delete → 清除所有时间
- Firefox：
Ctrl + Shift + Delete → 清除所有时间
第四步：验证结果
# 验证 CLI 版本
openclaw --version
# 应该显示新版本
# 验证 Gateway 状态
openclaw gateway status
# 应该显示 "Listening: 127.0.0.1:21827"
然后打开浏览器访问 http://你的NASIP/app/trim-openclaw/，检查版本显示是否正确。
🔄 出问题怎么恢复？
快速恢复
# 停止所有服务
pkill -f "openclaw-gateway"
pkill -f "<你的用户名>/server"
sleep 2
# 恢复用户目录
rm -rf /vol1/@apphome/<你的用户名>/data/openclaw
cp -r /vol1/@apphome/<你的用户名>/data/openclaw.backup.20260xxx /vol1/@apphome/<你的用户名>/data/openclaw
# 恢复 bun server 代码
cp /vol1/@appcenter/<你的用户名>/server/index.js.backup.20260xxx /vol1/@appcenter/<你的用户名>/server/index.js
# 重启服务
cd /vol1/@appcenter/<你的用户名>
bun /vol1/@appcenter/<你的用户名>/server/index.js &
sleep 3
openclaw gateway start
注意：把 20260xxx 改成你备份时的日期（如 20260413）
❓ 常见问题
Q：升级后 UI 还是显示旧版本？
A：清除浏览器缓存，或使用隐身模式访问。
Q：Gateway 无法启动？
A：检查配置文件，尝试恢复备份。
Q：提示权限不足？
A：确保使用正确的用户，或使用 sudo 提升权限。
📊 升级前后对比
| 项目 |
升级前 |
升级后 |
| CLI 版本 |
2026.3.13 |
2026.4.11 ✅ |
| UI 显示 |
2026.3.13 |
2026.4.11 ✅ |
| Gateway 版本 |
2026.3.13 |
2026.4.11 ✅ |
⚠️ 免责声明
- 本操作修改系统文件，升级前务必完成备份
- 不同版本可能有细节差异，请根据自己的实际情况调整
- 操作前请确认你理解每一步的作用
- 如果不确定，请先问有经验的朋友或助手
📎 附件
我整理了一份更详细的升级指南，包含完整的备份清单、恢复步骤、常见问题解答，需要的朋友可以自取。
有问题可以在评论区留言，看到会回复～
测试环境：飞牛 fnOS + OpenClaw 应用商店版
📎 参考来源
原文首发：飞牛 NAS OpenClaw 版本升级指南
本文档由 Shawn 和 沐汐 联合署名
未经作者授权禁止转载
附件：飞牛OpenClaw升级指南-通用版.zip
