OpenClaw 安装 | 部署新装系统环境设置1. 系统更新与升级2. 安装SSH服务3. 安装常用软件前置条件1.安装 Node.js2. 验证安装OpenClaw正式安装1. 执行安装命令2. 初始化OpenClaw3. 配置Nginx反向代理可不配置4. 开启内网访问OpenClaw问题解决1.origin not allowed错误2. control ui requires device identity (use HTTPS or localhost secure context)OpenClaw命令基础命令网关管理新装系统环境设置系统环境Ubuntu24.04 4C16G1. 系统更新与升级sudoaptupdatesudoaptupgrade-ysudoaptdist-upgrade-ysudoaptautoremove2. 安装SSH服务sudoaptinstallopenssh-serversudosystemctl startsshsudosystemctlenablessh3. 安装常用软件sudoaptinstall-ygitcurlwgethtopneofetchvimnanotmuxzshunzipziptar前置条件1.安装 Node.jsOpenClaw 要求 Node.js 22.12.0。Ubuntu / Debian 安装 Node.js 22curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejsCentOS / RHEL 安装 Node.js 22curl-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 use222. 验证安装node-v#应显示版本信息v22.xxx.xxxOpenClaw正式安装官网有一键安装脚本在此不予赘述。点击跳转官方网址1. 执行安装命令sudonpminstall-gqingchencloud/openclaw-zhlatest--registryhttps://registry.npmmirror.comopenclaw --version # 应输出版本信息 2026.3.7 openclaw --help 应显示中文帮助信息2. 初始化OpenClawopenclaw onboard 步骤1 ─→ 安全风险确认 --左键选择Yes确认 步骤2 ─→ 初始化模式 --快速开始 步骤3 ─→ 选择 AI 模型提供商 --注意选择国内站点 步骤4 ─→ 输入 API Key 步骤5 ─→ 选择默认模型 --注意选择国内站点 步骤6 ─→ 配置聊天通道Skipfornow跳过后续可配 步骤7 ─→ 搜索提供商Skipfornow跳过后续可配 步骤8 ─→ 安装技能Skipfornow跳过后续可配 步骤8 ─→ 启用 Hooks下面4项全选 步骤9 ─→ 完成3. 配置Nginx反向代理可不配置安装Nginxsudoaptinstallnginx-y启动并设置开机自启# 启动Nginxsudosystemctl start nginx# 设置开机自启sudosystemctlenablenginx配置反向代理sudonano/etc/nginx/sites-available/openclawserver{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 Connectionupgrade;# 传递真实客户端信息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 nginx4. 开启内网访问# 绑定到局域网openclaw configsetgateway.bind lan# 设置访问密码必须# 如openclaw config set gateway.auth.token 123 #123就是token密码openclaw configsetgateway.auth.token 你的密码# 重启生效openclaw gateway restartOpenClaw问题解决修改配置文件后记得重启网关以生效配置。openclaw gateway restart1.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 restart2. 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#开机自启