Web（网关）

适用范围

网关从与 WebSocket 服务器相同的端口（默认 18789）提供浏览器控制 UI。本页面涵盖绑定模式、远程访问和基本安全姿态。

控制 UI 详细信息：/docs/web/control-ui/。

如果资源存在（dist/control-ui），UI 默认启用。你可以通过配置控制它：

{
  gateway: {
    controlUi: { enabled: true, basePath: "/clawdbot" } // basePath 可选
  }
}

当启用钩子时，网关在同一 HTTP 服务器上公开 webhook 端点。请参阅 /docs/gateway/configuration/（钩子部分）。

ssh -N -L 18789:127.0.0.1:18789 user@host

保持网关仅回环并让 Tailscale Serve 代理它：

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

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

网关从 dist/control-ui 提供静态 UI 文件。在仓库中构建它们：

pnpm ui:build