飞牛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限制:用户级服务可能无法正常工作

03 详细安装步骤

一、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、飞牛等。

04 注意事项

因为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 &EOF
chmod +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完整教程,小白轻松上手

相关推荐
沃普天科技2 小时前
IF8032芯片TYPE C全功能输出支持C口显示器,支持AR眼镜 显示,支持接扩展坞,支持PD100W 4K144
游戏·智能手机·计算机外设·电脑·ar·音视频·显示器
monsion2 小时前
飞书开源 CLI:不是给你用的,是给 AI 用的
人工智能·开源·飞书
第十个灵魂2 小时前
OpenClaw Skill安装方式汇总
ai·skill·openclaw
泰兰尼斯稳稳鞋3 小时前
ARZOPA便携屏接电脑,频繁黑屏的问题解决
电脑
将心ONE3 小时前
电脑唤醒设置
电脑
16Miku3 小时前
飞书 lark-cli 深度解读:当办公软件遇上 AI Agent
人工智能·ai·飞书·agent·claudecode
枫桥骤雨3 小时前
OpenClaw接入飞书
飞书·openclaw
yubin12774086293 小时前
openclaw多agent-V2
多agent·openclaw