什么是 OpenClaw Control UI
OpenClaw Control UI 是一个 Web 界面,让你通过浏览器管理 OpenClaw,不用敲命令行。它运行在 Gateway 服务上,默认地址是 http://localhost:18789/。
如何打开 WebUI
本地访问
如果 Gateway 在同一台电脑上运行,访问很简单:
- 确保 Gateway 在运行。没有的话,执行:
openclaw gateway
- 打开浏览器,访问:
- http://127.0.0.1:18789/
- 或 http://localhost:18789/
- 第一次连接需要输入认证信息:
- Token:Gateway token(onboarding 向导生成的,或者手动创建)
- Password:Gateway 密码(临时用的,关闭浏览器后失效)
远程访问
想在其他设备上访问,有两种方式:
用 Tailscale Serve(推荐)
这种方式最安全,提供 HTTPS 加密。
- 启动 Gateway 时启用 Tailscale Serve:
openclaw gateway --tailscale serve
- 浏览器打开:
https://<你的-tailscale-节点名>/
绑定到 Tailnet + Token
不想用 Tailscale Serve 的话,可以直接绑定 tailnet:
- 启动 Gateway:
openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"
- 浏览器打开:
http://<你的-tailscale-ip>:18789/
- 在 UI 设置里粘贴生成的 token。
设备配对
从新浏览器或设备连接时,需要配对。如果看到 “disconnected (1008): pairing required”,这样做:
- 列出待批准请求:
openclaw devices list
- 批准设备:
openclaw devices approve <requestId>
- 刷新浏览器页面。
本地连接(127.0.0.1)会自动批准。远程连接需要手动批准。换个浏览器或清除了浏览器数据后需要重新配对。
WebUI 能做什么
聊天
- 和模型实时对话
- 看工具调用和输出
- 可以中止正在运行的对话
渠道管理
- WhatsApp/Telegram/Discord/Slack 状态管理
- 二维码登录
- 渠道配置
会话管理
- 看会话列表
- 设置 thinking/verbose 模式
定时任务
- 添加、编辑、运行、启用/禁用定时任务
- 查看历史记录
技能管理
- 启用/禁用技能
- 安装技能
- 更新 API 密钥
节点管理
- 看已配对的节点
配置管理
- 编辑配置文件
~/.openclaw/openclaw.json - 应用配置并重启
日志和调试
- 看实时日志
- 导出日志
- 手动 RPC 调用
更新
- 运行更新并重启
如何关闭 WebUI
临时关闭
想暂停访问但保持 Gateway 运行:
撤销已配对的设备:
openclaw devices revoke --device <id> --role <role>
或者编辑配置文件,改 bind 设置。
永久关闭
完全停止 Gateway:
openclaw gateway stop
或者如果 Gateway 在前台运行,按 Ctrl+C。
安全注意事项
HTTP vs HTTPS
用纯 HTTP 打开仪表板(比如 http://<lan-ip>),浏览器会在非安全上下文运行,会阻止 WebCrypto。默认情况下,OpenClaw 会阻止没有设备身份的连接。
推荐:
- 用 HTTPS(Tailscale Serve)
- 或在本地打开(http://127.0.0.1:18789/)
配置选项
如果必须在不安全的 HTTP 环境里用,可以改配置:
允许不安全认证:
{
"gateway": {
"controlUi": { "allowInsecureAuth": true },
"bind": "tailnet",
"auth": { "mode": "token", "token": "replace-me" }
}
}
禁用设备身份验证(危险):
{
"gateway": {
"controlUi": { "dangerouslyDisableDeviceAuth": true },
"bind": "tailnet",
"auth": { "mode": "token", "token": "replace-me" }
}
}
dangerouslyDisableDeviceAuth 会关闭设备身份检查,安全风险很大。紧急用完后赶紧改回来。
总结
OpenClaw Control UI 让管理 OpenClaw 更方便。本地访问直接去 http://localhost:18789/,远程访问推荐用 Tailscale Serve。记得用 HTTPS,保护好 token。