飞牛NAS安装OpenClaw完整记录

最近想着飞牛NAS既然是Linux系统，那么应该就能直接在系统层面上部署安装OpenClaw。

虽然说前段时间已经写过一篇部署CoPaw的教程，但是OpenClaw与CoPaw之间的差别还是有的。

平替OpenClaw，飞牛NAS安装国产小龙虾CoPaw教程

OpenClaw和CoPaw是什么？两者的区别是什么？

OpenClaw 和 CoPaw 都是 Agentscope 生态下的工具，核心定位都是为 AI Agent 应用提供运行时环境 / 交互界面。

今天咱们就在飞牛系统层面上安装OpenClaw。但是在系统层面上安装它，风险还是挺大的（怕操作不当导致数据丢失，所以建议在没有重要数据的NAS上部署）

小白这里是直接新建了一个飞牛系统进行操作。

01 安装环境

系统: 飞牛NAS（Debian GNU/Linux 12 bookworm）
内核: Linux 6.12.18-trim x86_64
架构: x86_64
主机名: airbyte-fnos

02 飞牛NAS的特殊性

基于Debian 12：兼容标准Linux命令
预装Node.js v18：需要升级到v22
systemd限制：用户级服务可能无法正常工作

详细安装步骤

一、SSH连接到飞牛

飞牛更新到1.1.19以上版本，SSH自动处于关闭状态，且需要给对应账户授权SSH权限才能正常连接，详细请看这篇文章：飞牛更新1.1.19版本之后，SSH无法使用了？

用SSH方式连接到飞牛之后，以普通用户的状态即可：如何使用SSH连接设备？很简单！

注意事项：如果复制粘贴执行命令出现【-bash xxx】之类的描述，有可能是复制之后的空格问题，删除所有空格再重新输入空格执行即可解决。

复制下面命令，先创建一个用户目录

sudo mkdir -p /home/airbyte

这里需要输入一下飞牛登录密码

再执行下面命令，给刚刚创建的用户目录设置权限

sudo chown airbyte:Users /home/airbyte

接着就可以开始下面内容了。

二、执行官方安装脚本

复制下面内容，粘贴到黑框，回车，然后等待一会儿。

curl -fsSL https://openclaw.ai/install.sh | bash

安装脚本会自动完成以下安装：

检测系统：linux
安装Node.js：v22.22.1
安装npm：10.9.4
安装构建工具：make/g++/cmake/python3
安装OpenClaw：v2026.3.13

如果因为Node.js提示版本是v18.20.4（非v22.22.1或以下的，可能需要手动更新），错误信息是：

npm WARN EBADENGINE Unsupported engine {  package: 'openclaw@2026.3.12',  required: { node: '>=22.16.0' },  current: { node: 'v18.20.4' }}

不用担心，OpenClaw命令会自动更新Node.js版本为v22.22.1或以上。

到这个界面基本上就快完成了。

到这里，一路都选择【yes】

过程中如果有【Skip for now】就选择这个，如果没有就选择第一项。

提示这个就已经完成了

三、访问飞牛NAS配置的OpenClaw

这时候小伙伴们就想着打开浏览器，访问部署在飞牛NAS上OpenClaw，迫不及待输入【飞牛局域网IP:18789】，访问发现……不通。

其实是因为

Gateway start blocked: set gateway.mode=local (current: unset) or pass --allow-unconfigured.

这时候复制下面内容，粘贴到SSH窗口

openclaw config set gateway.bind lan

注意：如果执行命令之后出现【-bash：openclaw：command not found】，是因为OpenClaw安装在 /home/用户名/.npm-global/bin/openclaw，但这个路径不在PATH中。

执行命令链接PATH环境

echo'export PATH="$HOME/.npm-global/bin:$PATH"'>>~/.bashrcsource~/.bashrc

接着再重新执行

openclaw config set gateway.bind lan

再执行下面命令修改Control UI允许的来源

openclaw config set gateway.controlUi.allowedOrigins '["*"]'

弄完之后建议执行一下（让OpenClaw gateway在后台运行，就算SSH窗口断开也不会退出OpenClaw）

pkill -f 'openclaw-gateway'nohup openclaw gateway --port 18789 > /tmp/openclaw-gateway.log 2>&1 &

这样就可以打开浏览器访问【飞牛IP:18789】了

不过别高兴得太早……，因为在网关令牌里输入token，你就会发现，又打不开……

错误提示：control ui requires device identity (use HTTPS or localhost secure context)原因：Control UI需要安全上下文（HTTPS或localhost）才能使用设备身份认证功能。

这时候建议在使用的电脑上建立SSH隧道，复制下面内容，根据情况修改，然后回车。（执行之后需要输入飞牛NAS的账户密码）

ssh -L 18789:127.0.0.1:18789 飞牛用户名@飞牛局域网IP比如小白这里是ssh -L 18789:127.0.0.1:18789 airbyte@192.168.33.226如果本地18789端口被占用，则改为其他端口，比如18780ssh -L 18780:127.0.0.1:18789 飞牛用户名@飞牛局域网IP

然后保持这个窗口运行，打开浏览器，输入【localhost:18789】（如果改动了本地端口，则使用【localhost:改动端口】，这样本地电脑访问的就是飞牛上的openclaw。

到这，飞牛上安装OpenClaw就已经安装好了，但是咱们还没有配置模型提供商和API、飞牛等。

注意事项

因为Gateway未设置为系统服务，仅当前使用nohup后台运行，飞牛重启后可能需要链接SSH然后执行下面命令。（有些飞牛不需要的哦，请自行测试）

nohup openclaw gateway --port 18789 > /tmp/openclaw-gateway.log 2>&1 &

--End--

安装完成OpenClaw之后，其实很多东西就能在SSH环境下使用命令行进行设置了。

设置社交软件机器人命令openclaw channels add运行交互式配置向导openclaw config wizard

如果飞牛重启之后，发现执行openclaw命令没反应，则可能是环境掉了。按照下面方式修复（逐一执行）

# 添加到.profileecho'export PATH="$HOME/.npm-global/bin:$PATH"'>>~/.profile

# 添加到.bash_profiletouch ~/.bash_profileecho 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bash_profile

cat > ~/start-openclaw.sh << 'EOF'#!/bin/bashexport PATH="$HOME/.npm-global/bin:$PATH"nohup openclaw gateway --port 18789 > ~/openclaw-gateway.log 2>&1 &EOFchmod +x ~/start-openclaw.sh

# 添加@reboot任务(crontab -l 2>/dev/null | grep -v 'start-openclaw'; echo '@reboot /home/airbyte/start-openclaw.sh') | crontab -

--End--

有手就会！OpenClaw接入飞书教程

好家伙，玩OpenClaw差点烧掉一幢楼的tokens……

工信部预警后，安全版小龙虾来了！1折就能养小龙虾，3分钟上手

Windows安装OpenClaw完整教程，小白轻松上手