7.1 Web概述

Web界面Web界面

Gateway 提供了一个基于浏览器的控制界面（使用 Vite + Lit 构建），可通过 http://<host>:18789/ 访问，支持可配置的路径前缀。

概述

Gateway 网关是 OpenClaw 的核心 Web 服务组件，提供统一的 HTTP/WebSocket 接口，用于管理和控制 OpenClaw 实例。它包含多个子功能模块，包括控制面板 UI、仪表板、WebChat 和 TUI 终端界面。

Webhooks

当 hooks.enabled=true 时可用，在 HTTP 服务器上暴露 webhook 端点，支持可配置的认证和负载选项。

控制面板 UI 配置

当静态资源存在时（dist/control-ui），控制面板 UI 默认启用。配置允许启用/禁用以及设置自定义的 basePath。

# 控制面板 UI 配置示例
gateway:
  controlUi:
    enabled: true
    basePath: "/"  # 可选：自定义路径前缀

Tailscale 集成

提供三种集成方式：

  • 集成 Serve（推荐）：Gateway 运行在回环地址上，通过 Tailscale Serve 代理
  • Tailnet 绑定：直接访问 Tailscale 网络，需要认证令牌
  • 公网访问（Funnel）：用于外部访问，需要密码认证

安全要点

安全警告
  • 认证默认强制要求（令牌、密码或 Tailscale 头部）
  • 非回环配置需要显式凭据
  • 当 allowTailscale 启用时，Tailscale 身份头部可替代显式认证
  • Funnel 模式特别要求基于密码的安全措施

构建

静态资源从 dist/control-ui 提供，使用以下命令构建：

pnpm ui:build

子页面导航

Web 界面包含以下子功能模块：

提示
更多详细信息请参考 官方英文文档。