open claw 使用记录

安装

安装 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

# 转发宿主机请求到 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 这个可以正常访问