一、环境说明

• 系统：Ubuntu 20.04 / 22.04（最稳）
• 架构：x86_64
• 端口：18789（管理面板 + API）
• 权限：必须 root 或 sudo 权限

二、安装依赖（必做）

sudoapt update &&sudoaptinstall-ycurlgitwget

安装 Node.js 22（必须这个版本）

curl-fsSL https://deb.nodesource.com/setup_22.x |sudo-Ebash -
sudoaptinstall-y nodejs

验证：

node-v# 应显示 v22.x
npm-v

安装 pnpm

npminstall-gpnpm--registry=https://registry.npmmirror.com

三、拉取 OpenClaw 源码

git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn

四、安装依赖 & 构建

pnpm config set registry https://registry.npmmirror.com
pnpminstall
pnpm ui:build
pnpm build

只要不报错红，就是正常。

五、初始化配置

pnpm openclaw onboard

按提示一路选：

1. yes
2. quickstart
3. 输入你的 OpenAI API Key（没有随便填，后面能改）
4. 工作目录：直接回车
5. 技能：skip

六、启动本地服务器（核心）

pnpm openclaw gateway --port18789--host0.0.0.0

看到类似：

Gateway running at http://0.0.0.0:18789

就成功了。

七、Linux 防火墙放行端口

sudo ufw allow 18789/tcp
sudo ufw reload

如果你是云服务器：阿里云 / 腾讯云 / 华为云 → 安全组 → 放行 18789 端口

八、本地 / 公网访问

1. 本机访问

浏览器打开：

http://127.0.0.1:18789

2. 局域网访问

http://Linux服务器IP:18789

3. 公网访问

http://公网IP:18789

第一次打开会让你设置：

• 管理员邮箱
• 管理员密码

设置完 直接就能用。

九、后台运行（关闭终端不退出）

pnpmadd-g pm2

启动后台：

pm2 start "pnpm openclaw gateway --port 18789 --host 0.0.0.0"--name openclaw

查看状态：

pm2 status
pm2 logs openclaw

开机自启：

pm2 save
pm2 startup

十、上线后怎么用？

1. 登录面板
2. 进入 模型渠道 → 填入可用的 API Key
3. 去 聊天 界面直接对话
4. 可对接：前端、小程序、API 调用