Dashboard 是大多数用户每天都会打开的地方。它不是“另一个聊天网页”,而是 OpenClaw 最直观的控制台入口。你会在这里看会话、看渠道、看日志、看状态、处理设备授权,也能直接发起第一次本地测试消息。
这页最适合什么时候看
如果你已经装好 OpenClaw,也能打开浏览器页面,但还不知道该先看哪里、怎么判断系统是不是正常,那这页就是最合适的入口。
1 分钟先看懂:Dashboard 到底是干什么的
官方文档里常见两个名字:Dashboard 和 Control UI。对大多数用户来说,可以先把它们理解成同一套浏览器控制界面。平时最常用的启动方式是:
openclaw dashboard
如果本机已经启动过 Gateway,这条命令通常会直接帮你打开浏览器页面。你不需要先把每个术语都背下来,只要先记住一件事:Dashboard 最重要的价值,是让你能同时看到会话、状态、日志和设备授权。
第一次打开以后,建议按这个顺序走
- 先看顶部或状态区,确认 Gateway 正在运行。
- 打开聊天主窗口,发送一条最简单的本地测试消息。
- 看左侧会话列表里有没有生成新会话。
- 切到 Logs,看有没有模型请求、消息路由或报错记录。
- 如果你已经接了渠道,再去看 Channels 状态,而不是反过来。
这个顺序的好处是:先确认 OpenClaw 自己是不是正常,再去判断飞书、钉钉、Telegram 这些平台接得对不对。
新手最该先认识的 5 个区域
会话列表
最适合看有没有新会话进来、上一段对话是不是还在持续、平台消息有没有真正进入系统。
聊天主窗口
这是第一次本地测试最推荐的地方,先在这里发一条消息,比一上来就在外部平台里反复试更容易排障。
状态与健康检查
Gateway 有没有在跑、模型是否可用、设备是否待批准、某条渠道是不是掉线,先从这里看最稳。
Logs
如果你只看一个排障入口,我更推荐先看日志。这里和 `openclaw logs --follow` 看的是同一条底层日志流。
Channels / Skills / Settings
更适合做状态确认和轻量调整,不适合第一次上手时同时改很多设置。
设备授权
如果你是远程访问、换设备访问,批准请求往往会先在这里暴露出来。
第一次打开最容易遇到的两种情况
情况 1:本地直接打开成功
如果你在本机用 127.0.0.1 打开,很多情况下会自动通过,不需要额外设备批准。
情况 2:提示要授权设备
如果你是远程打开、走 Tailnet,或者换了一台新设备访问 Control UI,就可能进入设备批准流程。官方给出的常用命令是:
openclaw devices list
openclaw devices approve <requestId>
如果你怀疑是网关令牌本身有问题,也可以先看当前 token:
openclaw config get gateway.auth.token
需要重新生成时,再用:
openclaw doctor --generate-gateway-token
在 Dashboard 里聊天时,最值得记住的几个细节
- 如果模型正在长时间生成,可以用界面里的 Stop,或者在聊天里用
/stop停下当前回合。 - 如果你想起一个全新上下文,优先新建会话,而不是在旧会话里硬切主题。
- 如果你怀疑会话状态已经乱了,可以用
/status快速看当前会话情况,再考虑/reset。 - 不要把“页面能打开”误认为“系统已经没问题”,真正有意义的是消息、日志和模型都一起工作。
什么时候看 Dashboard,什么时候回终端
更适合看 Dashboard
- 检查有没有新会话和新消息
- 确认某条渠道有没有收到入站消息
- 处理设备批准或看总体状态
- 快速浏览日志,而不是长时间 tail
更适合回终端
openclaw status --deep做健康检查openclaw logs --follow持续盯日志openclaw channels status --probe检查渠道探针openclaw doctor或--repair做环境修复
最稳的日常习惯
- 先开 Dashboard
- 有异常就看 Logs
- 看不清就回终端查 `status --deep`
- 别一上来就重装
最常见的 4 个误区
- 只盯聊天窗口,不看日志:很多问题其实日志里一眼就能看出来。
- 把 Dashboard 当成唯一入口:它很方便,但不是替代 CLI 的全部能力。
- 看到新会话就以为一切正常:新会话出现只说明消息进来了,不等于模型和工具已经可用。
- 多个设备随便开,不做授权管理:Control UI 带控制面能力,安全上不要太随意。
如果 Dashboard 打不开,先这样查
openclaw gateway status
openclaw status --deep
openclaw logs --follow
这三步通常比“直接重装”更有效。如果是远程访问问题,再看设备授权和当前令牌,而不是一上来改 workspace 或重配模型。
建议搭配阅读
- 看完这页,马上去读 Gateway 与 Workspace 理解,把“服务”和“目录”彻底分开。
- 如果你想记命令,下一页直接看 常用命令速查表。
- 如果你想做真正的可用验证,接着做 第一次发消息测试。