升级命令

sudo npm update -g @qingchencloud/openclaw-zh

3.13版本

• 可以局域网登录 及 反向代理登录。

新装系统环境设置

系统环境：
Ubuntu24.04 4C16G

1. 系统更新与升级

sudo apt update && sudo apt full-upgrade -y && sudo apt autoremove -y 

2. 安装SSH服务

sudo apt install openssh-server && sudo systemctl start ssh && sudo systemctl enable ssh

3. 安装常用软件

sudo apt install -y git curl wget vim nano unzip zip tar

前置条件

1. 安装 Node.js

OpenClaw 要求 Node.js >= 22.12.0。

• 以下命令22.x可改成24.x 都是长期维护版本；

• Ubuntu / Debian 安装 Node.js 22：

  curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs
  

• CentOS / RHEL 安装 Node.js 22：

  curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash - && sudo yum install -y nodejs
  

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

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

2. 验证安装

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

OpenClaw正式安装

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

1. 执行安装命令

sudo npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com --verbose

openclaw --version
# 应输出版本信息：
2026.3.7

openclaw --help
应显示中文帮助信息

2. 初始化OpenClaw

openclaw onboard


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

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

• 安装Nginx

  sudo apt install nginx -y
  

• 启动并设置开机自启

  # 启动Nginx并设置开机自启
  sudo systemctl start nginx && sudo systemctl enable nginx
  

• 配置反向代理

  sudo nano /etc/nginx/sites-available/openclaw
  

  注意修改IP！！！

  server {
      listen 80;
      server_name 192.168.168.141;  # 替换为你的虚机的静态IP
  
      location / {
          proxy_pass http://127.0.0.1:18789;
          proxy_http_version 1.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;
      }
  }
  

• 启用配置

  # 禁用默认配置
  sudo rm /etc/nginx/sites-enabled/default
  
  # 启用OpenClaw配置
  sudo ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/
  
  # 检测配置语法
  sudo nginx -t
  # 应该显示 “syntax is ok” “test is successful”
  
  # 重载Nginx使配置生效
  sudo systemctl reload nginx
  

4. 开启局域网访问

也可直接修改配置文件 .openclaw/openclaw.json

• 命令行配置；

注意修改 IP 地址 ！！！

# 绑定到局域网
openclaw config set gateway.bind lan

# 设置访问密码（必须）
# 如：openclaw config set gateway.auth.token 123  #123就是token密码
openclaw config set gateway.auth.token 你的密码

#允许IP origins（修改IP）
openclaw config set 'gateway.controlUi.allowedOrigins' '["http://192.168.168.140:18789"]'

#允许非安全认证（解决origin限制）
openclaw config set gateway.controlUi.allowInsecureAuth true

#禁用设备认证
openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true

# 重启生效
openclaw gateway restart

重启网关

openclaw gateway restart

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

OpenClaw命令

升级：sudo npm update -g @qingchencloud/openclaw-zh

• 基础命令

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 gateway install	#开机自启