系列 · OpenClaw超简单 06/ 15

OpenClaw超简单6:Control UI 使用指南

装好 OpenClaw、配好模型和 Channel 之后,你已经可以通过 Telegram 或飞书跟 Bot 聊天了。但如果想 看状态、改配置、查日志 ,就需要用到 Control UI——OpenClaw 自带的网页管理界面。 …

最近更新于 2026年3月25日

装好 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
OpenClaw超简单7:访问控制与安全设置 OpenClaw超简单5:微信 ClawBot 配置