控制面板 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
提示
更多详细信息请参考 官方英文文档。