OpenClaw 中文版 安装 | 部署 | 局域网访问 | 反向代理 (2026年3月9日）

新装系统环境设置

系统环境：
Ubuntu24.04 4C16G

1. 系统更新与升级

sudoaptupdate&&sudoaptupgrade-y&&sudoaptdist-upgrade-y&&sudoaptautoremove

2. 安装SSH服务

sudoaptinstallopenssh-server&&sudosystemctl startssh&&sudosystemctlenablessh

3. 安装常用软件

sudoaptinstall-ygitcurlwgethtopneofetchvimnanotmuxzshunzipziptar

前置条件

1.安装 Node.js

OpenClaw 要求 Node.js >= 22.12.0。

• Ubuntu / Debian 安装 Node.js 22：

  curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-&&sudoapt-getinstall-ynodejs

• CentOS / RHEL 安装 Node.js 22：

  curl-fsSLhttps://rpm.nodesource.com/setup_22.x|sudobash-&&sudoyuminstall-ynodejs

• 使用 nvm 安装（适用于所有系统）：

  # 安装 nvm（如果还没有）curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh|bash# 安装并使用 Node.js 22nvminstall22nvm use22

2. 验证安装

node-v#应显示版本信息：v22.xxx.xxx

OpenClaw正式安装

官网有一键安装脚本，在此不予赘述。
点击跳转官方网址

1. 执行安装命令

sudonpminstall-g@qingchencloud/openclaw-zh@latest--registry=https://registry.npmmirror.com

openclaw --version # 应输出版本信息： 2026.3.7 openclaw --help 应显示中文帮助信息

2. 初始化OpenClaw

openclaw onboard 步骤1 ─→ 安全风险确认 --（左键选择Yes确认） 步骤2 ─→ 初始化模式 --（快速开始） 步骤3 ─→ 选择 AI 模型提供商 --（注意选择国内站点） 步骤4 ─→ 输入 API Key 步骤5 ─→ 选择默认模型 --（注意选择国内站点） 步骤6 ─→ 配置聊天通道（Skipfornow跳过，后续可配） 步骤7 ─→ 搜索提供商（Skipfornow跳过，后续可配） 步骤8 ─→ 安装技能（Skipfornow跳过，后续可配） 步骤8 ─→ 启用 Hooks（下面4项全选） 步骤9 ─→ 完成！

3. 配置Nginx反向代理（可不配置）

• 安装Nginx

  sudoaptinstallnginx-y

• 启动并设置开机自启

  # 启动Nginxsudosystemctl start nginx# 设置开机自启sudosystemctlenablenginx

• 配置反向代理

  sudonano/etc/nginx/sites-available/openclaw

  server{listen80;server_name192.168.168.141;# 替换为你的虚机的静态IPlocation /{proxy_pass http://127.0.0.1:18789;proxy_http_version1.1;# WebSocket支持（必须！）proxy_set_header Upgrade$http_upgrade;proxy_set_header Connection"upgrade";# 传递真实客户端信息proxy_set_header Host$host;proxy_set_header X-Real-IP$remote_addr;proxy_set_header X-Forwarded-For$proxy_add_x_forwarded_for;proxy_set_header X-Forwarded-Proto$scheme;# 长连接超时设置proxy_read_timeout 3600s;proxy_send_timeout 3600s;}}

• 启用配置

  # 禁用默认配置sudorm/etc/nginx/sites-enabled/default# 启用OpenClaw配置sudoln-s/etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/# 测试配置语法sudonginx-t# 应该显示 "test is successful"# 重载Nginx使配置生效sudosystemctl reload nginx

4. 开启内网访问

# 绑定到局域网openclaw configsetgateway.bind lan# 设置访问密码（必须）# 如：openclaw config set gateway.auth.token 123 #123就是token密码openclaw configsetgateway.auth.token 你的密码# 重启生效openclaw gateway restart

OpenClaw问题解决

修改配置文件后记得重启网关以生效配置。

openclaw gateway restart

1.origin not allowed错误

origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)

nano~/.openclaw/openclaw.json

在 gateway 部分添加 controlUi.allowedOrigins

{"gateway":{"bind":"loopback","port":18789,"controlUi":{"allowedOrigins":["http://192.168.168.141"]#此处添加你的静态IP地址},"auth":{"mode":"token"}}}

重启网关

openclaw gateway restart

2. control ui requires device identity (use HTTPS or localhost secure context)

nano~/.openclaw/openclaw.json# 修改 controlUi 部分{"gateway":{"bind":"loopback","port":18789,"controlUi":{"allowInsecureAuth":true, // 允许HTTP下的认证"dangerouslyDisableDeviceAuth":true, // 禁用设备认证（缺一不可！）"allowedOrigins":["http://192.168.168.141"]},"auth":{"mode":"token"}}}# 重启网关openclaw gateway restart

至此就能打开浏览器访问了。

OpenClaw命令

基础命令

openclaw#启动openclaw onboard#初始化向导openclaw dashboard#打开控制台openclaw config#查看配置openclaw skills#管理技能openclaw--help#查看帮助openclaw update#检查更新openclaw doctor#诊断修复openclaw daemon start#守护进程启动openclaw daemon stop#守护进程停止

网关管理

openclaw gateway run#前台运行openclaw gateway start#后台启动openclaw gateway stop#停止openclaw gateway restart#重启openclaw gateway status#查看状态openclaw gatewayinstall#开机自启