装好 OpenClaw、配好模型和 Channel 之后,你已经可以通过 Telegram 或飞书跟 Bot 聊天了。但如果想看状态、改配置、查日志,就需要用到 Control UI——OpenClaw 自带的网页管理界面。
一、Control UI 是什么
Control UI 是 OpenClaw Gateway 内置的一个网页应用,Gateway 启动后会自动在本地提供这个页面。
默认地址:
http://127.0.0.1:18789/
打开它最简单的方式是在终端执行:
openclaw dashboard
这条命令会自动打开浏览器并跳转到 Control UI 页面。
二、界面总览
进入 Control UI 后,主要有以下几个区域:
聊天与 Agent 控制
- 直接在网页里跟 Agent 对话(等同于在 Telegram/飞书里发消息)
- 实时看到 Agent 调用工具的过程
- 随时点击停止中断正在运行的任务
Channel 状态
- 查看所有已配置 Channel 的连接状态(Telegram、飞书、微信等)
- 部分 Channel(如 WhatsApp)可以在这里直接扫码登录
会话管理
- 查看当前和历史对话记录
- 手动重置会话(清空上下文)
- 调整模型的 thinking/reasoning 模式
Skills 管理
- 查看已安装的 Skills
- 安装新 Skill、管理 API Key
配置编辑
- 直接在网页里编辑
openclaw.json配置文件 - 有并发编辑保护,不会和终端编辑冲突
日志与诊断
- 实时查看 Gateway 日志(等同于
openclaw logs --follow) - 筛选日志级别
- 健康状态快照
三、常用操作
查看 Agent 运行状态
打开 Control UI 首页,可以看到 Gateway 是否在线、Channel 连接情况、当前是否有任务在跑。
等同于在终端执行:
openclaw status
openclaw gateway status
openclaw channels status --probe
重置会话
在会话列表里找到对应的对话,点击重置,Bot 会忘掉之前的对话内容,重新开始。
也可以在任意 Channel 里直接发:
/new
或者:
/reset
查看和修改配置
在 Control UI 的配置编辑器里,可以直接修改 openclaw.json 并保存。修改后 Gateway 会自动热重载,无需重启。
排查问题
遇到 Bot 没有响应或报错时,打开 Control UI 的日志面板,实时过滤 error 级别日志,通常能快速定位问题。
等同于:
openclaw logs --follow
openclaw doctor
四、远程访问(非必须)
默认情况下 Control UI 只能在本机访问。如果你的 OpenClaw 装在远程服务器上,想从其他设备访问,推荐用 Tailscale:
openclaw gateway --tailscale serve
这样可以在 Tailnet 内安全访问,而不需要把端口暴露到公网。
如果只是临时远程访问,也可以用 SSH 端口转发:
ssh -L 18789:127.0.0.1:18789 your-server
然后在本地浏览器访问 http://127.0.0.1:18789/ 即可。
五、登录 token 问题
偶尔会遇到 Control UI 要求输入 token 的情况。可以用以下命令获取:
openclaw config get gateway.auth.token
如果 token 丢失或失效,重新生成:
openclaw doctor --generate-gateway-token