OpenClaw 升级步骤（飞牛NAS）
适用环境
- 系统：飞牛NAS (fnOS)
- 当前已安装 OpenClaw 套件
- 目标：升级 OpenClaw 到新版本
升级步骤
1. 确定目标版本
先查询最新版本：
# 方法一：npm 查询
npm view openclaw versions --json | tail -20
# 方法二：直接查询最新
npm view openclaw version
2. 修改版本锁定
编辑文件：/vol1/@apphome/trim.openclaw/data/openclaw/package.json
找到 dependencies 中的 openclaw 字段，修改版本号：
{
"dependencies": {
"openclaw": "^2026.4.24"
}
}
将版本号替换为目标版本，如 2026.4.24
3. 更新显示版本（可选）
编辑文件：/vol1/@appcenter/trim.openclaw/config/openclaw-version.env
OPENCLAW_VERSION=2026.4.24
此文件仅用于 UI 显示，不影响实际运行
4. 安装新版本
cd /vol1/@apphome/trim.openclaw/data/openclaw
sudo -u trim.openclaw bun install
5. 重启服务
方法A：通过飞牛 UI
- 打开飞牛应用中心
- 找到 OpenClaw
- 点击停止，等待停止完成
- 点击启动
方法B：命令行重启
# 杀掉所有 openclaw 进程
sudo pkill -9 -f "openclaw"
# 等待管理器自动重启（约5-10秒）
sleep 10
# 验证进程已启动
ps aux | grep openclaw
6. 验证升级成功
# 检查版本
/vol1/@apphome/trim.openclaw/data/openclaw/node_modules/.bin/openclaw --version
# 检查端口
ss -tlnp | grep 16272
# 检查日志
tail -20 /vol1/@apphome/trim.openclaw/data/openclaw/gateway.log
常见问题
Q: bun install -g openclaw@latest 为什么不行？
这个命令只更新全局 CLI 工具（在 ~/.bun/install/global/），不影响套件内的网关代码。套件从 node_modules/.bin/openclaw 读取二进制。
Q: 升级后 UI 显示版本不对？
检查两个文件：
package.json 中的版本是否正确openclaw-version.env 是否更新
Q: Gateway 启动失败？
- 检查旧进程是否残留：
ps aux | grep openclaw
- 杀掉残留进程：
sudo pkill -9 -f openclaw
- 查看日志：
tail -f /vol1/@apphome/trim.openclaw/data/openclaw/gateway.log
Q: browser 插件安装失败？
这是已知问题，playwright-core 依赖可能安装失败。不影响核心功能，可以忽略。
关键文件路径
| 文件 |
用途 |
/vol1/@apphome/trim.openclaw/data/openclaw/package.json |
依赖版本锁定（升级时修改） |
/vol1/@appcenter/trim.openclaw/config/openclaw-version.env |
UI 显示版本 |
/vol1/@apphome/trim.openclaw/data/openclaw/node_modules/.bin/openclaw |
实际运行的网关 |
/vol1/@apphome/trim.openclaw/data/openclaw/gateway.log |
运行日志 |
/vol1/@apphome/trim.openclaw/data/home/.openclaw/openclaw.json |
配置文件 |
示例：完整升级命令
# 假设目标版本 2026.4.24
TARGET_VERSION="2026.4.24"
# 修改 package.json
sed -i "s/\"openclaw\": \"\^[^\"]*\"/\"openclaw\": \"^${TARGET_VERSION}\"/" \
/vol1/@apphome/trim.openclaw/data/openclaw/package.json
# 更新显示版本
echo "OPENCLAW_VERSION=${TARGET_VERSION}" > \
/vol1/@appcenter/trim.openclaw/config/openclaw-version.env
# 安装
cd /vol1/@apphome/trim.openclaw/data/openclaw
sudo -u trim.openclaw bun install
# 重启
sudo pkill -9 -f openclaw
# 等待重启
sleep 10
# 验证
ps aux | grep openclaw && \
/vol1/@apphome/trim.openclaw/data/openclaw/node_modules/.bin/openclaw --version
最后更新：2026-04-26
