Web 界面概览

Gateway 在同一端口上提供一个小型浏览器控制界面（Control UI，基于 Vite + Lit 构建）。

• 默认地址：http://<主机>:18789/
• 可选前缀：设置 gateway.controlUi.basePath

当 hooks.enabled=true 时，Gateway 还会暴露一个小型 webhook 端点。

控制界面（Control UI）

Control UI 在资源文件存在时（dist/control-ui）默认启用。

配置示例：

{
  gateway: {
    controlUi: {
      enabled: true,
      basePath: "/openclaw"
    }
  }
}

详细信息请参阅 Control UI。

Tailscale 访问模式

OpenClaw 支持多种 Tailscale 访问模式：

模式	说明
集成 Serve（推荐）	使用 Tailscale Serve 代理，提供 HTTPS 访问
Tailnet 绑定 + Token	绑定到 tailnet 并使用 token 认证
公网（Funnel）	通过 Tailscale Funnel 暴露到公网

安全须知

• Gateway 认证默认开启。
• 非回环绑定仍然需要共享 token 或密码。
• 安装向导默认会生成一个 gateway token。
• 对于非回环的 Control UI 部署，需显式设置 gateway.controlUi.allowedOrigins。

构建 UI

Gateway 从 dist/control-ui 提供静态文件。使用以下命令构建：

pnpm ui:build # 首次运行时自动安装 UI 依赖

Web 界面组件

• Control UI — 浏览器控制界面，完整的管理面板
• 仪表盘 — 快速访问 Gateway 仪表盘
• TUI — 终端用户界面
• WebChat — 原生聊天 UI（macOS/iOS）