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