安装
安装 GMSSH
别敲命令了！这个「GMSSH」国产终端工具，让你像玩电脑一样管理服务器！飞牛nas实践。
添加机器
打开 GMSSH 桌面
这一步第一次需要久一点
安装 node
- 应用中心先安装 node 管理器
- 打开 node 管理器
- 根据提示安装 nvm
- 刷新一下node版本，选择最高版本安装，当前是 25.8.1
注意
- 安装完后 nvm node 都是安装到 root 用户了，所以需要登录到root 用户。
- 先设置或更改下 root 用户密码
sudo passwd root - 系统会提示输入新密码并确认。完成后，root 用户的密码已成功设置。
- 切换到 root 用户
su root - root 用户刷新 shell 环境
ource /root/.bashrc- 检测
nvm -v是否正确 - 如果不正确查看手动安装的文档
- 检测
手动安装
Linux 下安装与使用 NVM（Node Version Manager）全指南 — geek-blogs.com
安装 nginx
# 2. 装 Nginx（轻量，不占资源）
sudo apt install nginx
# 3. 启动并设置开机自启
sudo systemctl start nginx
sudo systemctl enable nginx
# 检查配置是否有错（关键！）
sudo nginx -t
# 重启 Nginx 加载配置
sudo systemctl restart nginx
# 转发宿主机请求到 openclaw 的 18789 端口
server {
listen 8080;
listen 0.0.0.0;
# 解决请求头/Cookie 过大问题
client_header_buffer_size 64k;
large_client_header_buffers 4 64k;
client_max_body_size 100m;
# 核心：智能识别 WebSocket 升级请求（兼容 HTTP）
location / {
proxy_pass http://127.0.0.1:18789;
# 基础 HTTP 转发配置
proxy_set_header Host 127.0.0.1;
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;
# WebSocket 专属配置（自动触发）
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
# 关键：动态判断是否升级为 WebSocket（兼容普通 HTTP）
proxy_set_header Connection $connection_upgrade;
# 超时配置（WebSocket 长连接 + HTTP 短连接兼容）
proxy_connect_timeout 60s;
proxy_read_timeout 3600s; # WebSocket 长连接超时
proxy_send_timeout 3600s;
# 性能/兼容性配置
proxy_buffer_size 64k;
proxy_buffers 4 64k;
proxy_busy_buffers_size 128k;
proxy_cache off; # 关闭缓存（WebSocket 必须）
}
}
# 必须添加：定义动态 Connection 头（核心兼容逻辑）
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
安装 OpenClaw
安装
npm install -g openclaw@latest
运行新手引导
openclaw onboard --install-daemon
配置本地模型
http://192.168.1.130:11434 model: ollama/qwen3.5:27b
快速检查
openclaw doctor
检查 Gateway 网关健康状态
openclaw status + openclaw health
打开仪表板
openclaw dashboard
启动
openclaw gateway
升级
npm update -g openclaw
宿主机访问
宿主机使用 http://192.168.195.129:8080/config 直接访问时，出现：
OpenClaw Control UI安全上下文访问配置_openclaw control ui安全上下文访问配置 csdn-CSDN博客
建立 SSH 隧道
ssh -L 8080:localhost:18789 pi@192.168.195.129
http://127.0.0.1:8080/config 这个可以正常访问
如何向远程服务器添加公私钥以进行无密码SSH身份验证 - 知乎
当系统重启就需要重新建立SSH隧道
局域网内访问
什么是 “Pairing required” 错误？
当你第一次连接 OpenClaw Gateway 或在新的浏览器/设备上访问控制面板时，系统会抛出 disconnected (1008): pairing required 错误。这是 OpenClaw 的安全配对机制在起作用——类似于 SSH 的已知主机验证，确保只有授权设备能访问你的 AI 代理网关。
OpenClaw Pairing required 错误解决方案详解 - 知乎
