OpenClaw Gateway 默认绑定本地回环地址，通过 SSH 隧道可实现从 Windows 安全访问虚拟机上的服务。详述了 SSH 隧道端口转发命令、Windows 下生成 SSH 密钥及免密登录配置步骤，包括创建快捷启动脚本的方法。同时列出了常见连接错误（如 Connection refused、Host key verification failed）的排查方案及 Gateway 相关配置文件的查看方式，帮助用户快速建立稳定的远程连接环境。
┌─────────────────────┐ ┌─────────────────────┐
│ Windows 主机 │ │ 虚拟机/服务器 │
│ │ │ │
│ 浏览器 ◄───────────┼───┼──► OpenClaw Gateway │
│ localhost:18790 │ │ 127.0.0.1:18789 │
│ SSH 隧道 │ │ │
└─────────────────────┘ └─────────────────────┘
OpenClaw Gateway 默认绑定在 127.0.0.1（本地回环），这是最安全的配置。直接绑定 LAN IP 可能会遇到 WebSocket 认证问题（1008 错误）。
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]
隧道建立后，在浏览器打开：
http://localhost:18790/?token=你的 Token
或者打开 http://localhost:18790，然后手动输入 Token。
每次 SSH 都输密码很麻烦，配置密钥认证可以实现免密登录。
打开 PowerShell，运行：
ssh-keygen -t ed25519
提示时一路回车（不设置密码）。
会生成两个文件：
C:\Users\你的用户名\.ssh\id_ed25519 — 私钥（保密）C:\Users\你的用户名\.ssh\id_ed25519.pub — 公钥（可公开）运行以下命令（一行）：
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh 用户名@虚拟机IP "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"
实际示例：
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh [email protected] "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"
这次需要输入密码，之后就不用了。
ssh [email protected] "echo 免密登录成功"
如果显示 免密登录成功 而不要求输密码，配置完成！
在桌面（或任意位置）创建 openclaw 隧道.bat：
@echo off
chcp 65001 >nul
echo ========================================
echo OpenClaw Gateway SSH 隧道
echo ========================================
echo.
echo 正在连接到 Gateway...
echo.
echo 连接成功后，请访问：
echo http://localhost:18790
echo.
echo [!] 保持此窗口开启
echo [!] 关闭窗口会断开连接
echo.
echo ----------------------------------------
ssh -N -L 18790:127.0.0.1:18789 [email protected]
将
[email protected]替换为你的实际用户名和 IP。
openclaw 隧道.bathttp://localhost:18790openclaw 隧道.bat → 创建快捷方式原因： 虚拟机未启动或 SSH 服务未运行。
解决：
# 在虚拟机上检查 SSH 服务
sudo systemctl status sshd
# 如果未运行，启动它
sudo systemctl start sshd
原因： 服务器指纹变更（重装系统等）。
解决：
# 删除旧的指纹记录
ssh-keygen -R 162.16.30.210
检查清单：
# 在虚拟机上执行
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
cat ~/.ssh/authorized_keys
# 确保这些选项没有被禁用
grep -E "PubkeyAuthentication|AuthorizedKeysFile" /etc/ssh/sshd_config
原因： Token 验证失败。
解决：
~/.openclaw/openclaw.json 中的 gateway.auth.token）直接重新运行 openclaw 隧道.bat 或 SSH 命令即可。
Windows 上可以用 start 命令：
start /min ssh -N -L 18790:127.0.0.1:18789 [email protected]
或者使用 nssm 等工具将其注册为 Windows 服务。
~/.openclaw/openclaw.json
cat ~/.openclaw/openclaw.json | grep -A2 '"auth'"
openclaw gateway restart
openclaw status openclaw health
| 步骤 | 命令/操作 |
|---|---|
| 1. 建立隧道 | ssh -N -L 18790:127.0.0.1:18789 user@host |
| 2. 生成密钥 | ssh-keygen -t ed25519 |
| 3. 复制公钥 | `type ... |
| 4. 创建脚本 | 保存为 .bat 文件双击运行 |
| 5. 访问 | http://localhost:18790/?token=xxx |
配置一次，以后只需双击脚本即可连接！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online