7.2 控制面板

控制面板 UI 是 OpenClaw 基于浏览器的管理界面,使用 Vite + Lit 构建,由 Gateway 提供服务。

核心功能

控制面板 UI 提供以下功能:

  • 聊天交互 - 支持流式工具调用和实时输出卡片
  • 渠道管理 - 管理 WhatsApp、Telegram、Discord、Slack 等渠道,支持二维码登录
  • 会话和实例监控 - 实时监控活动会话和实例状态
  • 定时任务管理 - 管理和配置 Cron 定时任务
  • 技能配置 - 配置和管理 AI 技能
  • 配置编辑 - 带验证和并发编辑保护的配置编辑器
  • 实时日志 - 日志尾随和调试工具
  • 包更新 - 支持包更新和重启报告

访问方式

本地访问

当 Gateway 在本地运行时,连接到 http://127.0.0.1:18789/

# 启动 Gateway
openclaw gateway

# 然后在浏览器中打开
# http://127.0.0.1:18789/

网络访问

推荐使用以下方式进行安全的网络访问:

  • Tailscale Serve with HTTPS(推荐) - 最安全的远程访问方式
  • Tailnet 绑定 - 使用认证令牌绑定到您的 tailnet
# 使用 Tailscale Serve 暴露 Gateway
tailscale serve --bg 18789

# 或使用 Tailscale Funnel 进行公网访问(需要密码认证)
tailscale funnel --bg 18789

安全注意事项

安全警告

系统默认阻止通过不安全的 HTTP 连接控制面板 UI,以防止 WebCrypto 漏洞。如果您信任您的网络,可以启用仅令牌的 HTTP 访问,但推荐使用 HTTPS 或本地回环访问。

配置示例

# Gateway 控制面板 UI 配置
gateway:
  controlUi:
    enabled: true
    basePath: "/"
  auth:
    token: "your-secure-token"  # 或使用环境变量 OPENCLAW_GATEWAY_TOKEN
    # password: "your-password"  # 用于 Funnel 模式
  bind: "127.0.0.1"  # 绑定到回环地址以确保安全
  port: 18789

开发模式

开发者可以使用以下命令进行本地开发:

# 编译控制面板 UI
pnpm ui:build

# 运行本地开发服务器(可通过 WebSocket 配置连接到远程 Gateway)
pnpm ui:dev
提示
更多详细信息请参考 官方英文文档