OpenClaw搭建(小龙虾)

第一阶段：基础环境搭建

OpenClaw是基于Node.js运行的，所以这一步至关重要。

1、更新系统并安装基础工具

打开你的Ubuntu终端，先运行以下命令，确保系统是最新的，并安装必要的编译工具（防止后续依赖报错）：

sudo apt updatesudo apt upgrade -ysudo apt install -y curl git build-essential python3

2、安装Node.js（核心依赖）

OpenClaw要求Node.js版本必须≥ v22。为了方便管理，我推荐使用NodeSource源来安装，这样最稳妥。

下载并执行安装脚本（Node.js 22）：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash –

(注：如果网络超时，可以尝试使用国内镜像源，或者手动下载安装包)

安装Node.js：

sudo apt-get install -y nodejs

验证版本：

输入：

node -v

确保显示的是v22.x.x或更高版本。

同时检查npm版本：

npm -v

第二阶段：安装OpenClaw

环境准备好后，安装OpenClaw本体就非常简单了，官方提供了一键脚本。

1、执行一键安装、在终端中直接运行官方提供的安装命令：

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

安装完成啦！！！

第三阶段：初始化与配置

选择“Yes”，进入下一步

选择“QuickStart”，进入下一步

选择大模型，我这里选择“DeepSeek”

注：需要在大模型中注册账号与充值；

把大模型的Key加入进去

选择“Keep current”，进行下一步

选择“Skip for now”，进行下一步

选择“Do this later”，到这里Open Claw初始化配置完成；

第四阶段：配置远程可登录

第一步：修改绑定模式（开门）

默认情况下，OpenClaw只监听127.0.0.1（本机）。我们需要把它改成lan模式，让它监听所有网卡。

openclaw config set gateway.bind lan

作用：将服务从“仅本机”切换到“局域网可访问”。

验证：稍后重启后，服务会监听0.0.0.0:18789。

第二步：配置允许的来源（解决跨域报错）

浏览器出于安全考虑，如果访问地址和服务器地址不一致（比如你在另一台电脑访问服务器IP），会报origin not allowed错误。我们需要把服务器的IP加入白名单。

#请将192.168.1.100 替换为你Ubuntu 的实际局域网IPopenclaw config set 'gateway.controlUi.allowedOrigins' '["http://192.168.1.100:18789", "http://localhost:18789", "http://127.0.0.1:18789"]'

第三步：调整安全认证（解决登录繁琐问题）

在局域网内，每次都要找Token或者处理HTTPS证书会很麻烦。为了方便使用，建议开启“非安全认证”模式。

#允许HTTP 协议访问（解决非HTTPS 报错）openclaw config set gateway.controlUi.allowInsecureAuth true

#禁用设备认证（可选，仅限家庭/可信局域网）#开启后不需要输入复杂的设备验证码，直接进后台openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true

⚠️安全提醒：dangerouslyDisableDeviceAuth会降低安全性。如果你的网络环境是公共办公区（如公司内网），建议不要开启此项，或者确保你的API Key和Token足够复杂。

第四步：重启网关（生效）

配置改完后，必须重启服务才能生效。

openclaw gateway restart