Gateway 在与 WebSocket 相同的端口上提供浏览器 Control UI(Vite + Lit):

  • 默认:http://<host>:18789/
  • 启用 TLS:https://<host>:18789/
  • 可选前缀:gateway.controlUi.basePath(如 /openclaw)

Web 界面组件

组件说明页面
Control UI浏览器管理界面(聊天、配置、节点、技能等)web-control-ui
Dashboard仪表板入口与认证web-dashboard
TUI终端用户界面web-tui
WebChat原生聊天 UI(macOS/iOS)web-webchat

Webhook

当 hooks.enabled=true 时,Gateway 在同一 HTTP 服务器上暴露 webhook 端点。

Tailscale 访问模式

集成 Serve(推荐)

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "serve" }
  }
}

访问:https://<magicdns>/

Tailnet 绑定 + Token

{
  gateway: {
    bind: "tailnet",
    auth: { mode: "token", token: "your-token" }
  }
}

公网(Funnel)

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "funnel" },
    auth: { mode: "password" }
  }
}

安全要点

  • 非 loopback 绑定仍需要 Gateway 认证
  • 非 loopback Control UI 部署必须显式设置 gateway.controlUi.allowedOrigins
  • Tailscale Funnel 要求 gateway.auth.mode: "password"
  • 使用 Tailscale Serve 时,gateway.auth.allowTailscale: true 可让身份头满足认证

构建 UI

pnpm ui:build