OpenClaw 远程访问配置指南：SSH 隧道与免密登录
一、场景说明
网络架构
┌─────────────────────┐ ┌─────────────────────┐
│ Windows 主机 │ │ 虚拟机/服务器 │
│ │ │ │
│ 浏览器 ◄───────────┼───┼──► OpenClaw Gateway │
│ localhost:18790 │ │ 127.0.0.1:18789 │
│ SSH 隧道 │ │ │
└─────────────────────┘ └─────────────────────┘
为什么需要 SSH 隧道？
OpenClaw Gateway 默认绑定在 127.0.0.1（本地回环），这是最安全的配置。直接绑定 LAN IP 可能会遇到 WebSocket 认证问题（1008 错误）。
SSH 隧道的优势：
- ✅ 安全（加密传输）
- ✅ 稳定（避免 WebSocket 直连问题）
- ✅ 无需修改 Gateway 配置
二、SSH 隧道访问
基本命令
在 Windows PowerShell 中运行：
ssh -N -L 18790:127.0.0.1:18789 用户名@虚拟机IP
参数说明：
| 参数 | 说明 |
|---|---|
-N | 不执行远程命令，只做端口转发 |
-L | 本地端口转发 |
18790 | Windows 本地端口（可自定义） |
127.0.0.1:18789 | 虚拟机上的 Gateway 地址 |
用户名@虚拟机 IP | SSH 登录信息 |
实际示例：
ssh -N -L 18790:127.0.0.1:18789 [email protected]
访问 Gateway
隧道建立后，在浏览器打开：
http://localhost:18790/?token=你的 Token
或者打开 http://localhost:18790，然后手动输入 Token。
三、配置免密登录
每次 SSH 都输密码很麻烦，配置密钥认证可以实现免密登录。
步骤 1：生成 SSH 密钥（Windows）
打开 PowerShell，运行：
ssh-keygen -t ed25519
提示时一路回车（不设置密码）。
会生成两个文件：
C:\Users\你的用户名\.ssh\id_ed25519— 私钥（保密）C:\Users\你的用户名\.ssh\id_ed25519.pub— 公钥（可公开）
