Gateway 仪表板是 Control UI 提供的浏览器界面,默认路径 /(可通过 gateway.controlUi.basePath 覆盖)。
快速访问
http://127.0.0.1:18789/ # 本地 Gateway
https://127.0.0.1:18789/ # 启用 TLS 时
认证方式
认证在 WebSocket 握手时执行:
connect.params.auth.tokenconnect.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:// |
| 共享密钥 token | gateway.auth.token 或 OPENCLAW_GATEWAY_TOKEN |
| 共享密钥 password | gateway.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-tokenAUTH_TOKEN_MISMATCH:客户端可用缓存设备 token 重试一次;仍失败则手动修复 token 漂移AUTH_SCOPE_MISMATCH:设备 token 已识别但缺少请求的 scope;重新配对或审批新 scope
相关页面
- web-control-ui — Control UI 详细功能
- web-webchat — WebChat 聊天界面