Gateway 仪表板是 Control UI 提供的浏览器界面,默认路径 /(可通过 gateway.controlUi.basePath 覆盖)。

快速访问

http://127.0.0.1:18789/          # 本地 Gateway
https://127.0.0.1:18789/         # 启用 TLS 时

认证方式

认证在 WebSocket 握手时执行:

  • connect.params.auth.token
  • connect.params.auth.password
  • Tailscale Serve 身份头(gateway.auth.allowTailscale: true)
  • trusted-proxy 身份头(gateway.auth.mode: "trusted-proxy")

安全提示:Control UI 是管理面(聊天、配置、exec 审批),不要公开暴露。推荐使用 localhost、Tailscale Serve 或 SSH 隧道。

快速路径

openclaw dashboard  # 复制链接,尝试打开浏览器,无头时显示 SSH 提示

本地 vs 远程认证

场景方式
Localhost直接打开 http://127.0.0.1:18789/
Gateway TLS使用 https:// 和 wss://
共享密钥 tokengateway.auth.token 或 OPENCLAW_GATEWAY_TOKEN
共享密钥 passwordgateway.auth.password 或 OPENCLAW_GATEWAY_PASSWORD
Tailscale Serve身份头满足认证,无需粘贴密钥
非 localhost使用 Tailscale Serve、SSH 隧道或 trusted-proxy

排查 “unauthorized” / 1008

# 本地检查
openclaw status
 
# 远程 SSH 隧道
ssh -N -L 18789:127.0.0.1:18789 user@host
 
# 获取 token
openclaw config get gateway.auth.token
 
# 生成新 token
openclaw doctor --generate-gateway-token
  • AUTH_TOKEN_MISMATCH:客户端可用缓存设备 token 重试一次;仍失败则手动修复 token 漂移
  • AUTH_SCOPE_MISMATCH:设备 token 已识别但缺少请求的 scope;重新配对或审批新 scope

相关页面