OpenClaw Docs CN

基础使用 / 控制台入口

Dashboard 操作指南

Dashboard 是大多数用户每天都会打开的地方。它不是“另一个聊天网页”,而是 OpenClaw 最直观的控制台入口。你会在这里看会话、看渠道、看日志、看状态、处理设备授权,也能直接发起第一次本地测试消息。

这页最适合什么时候看

如果你已经装好 OpenClaw,也能打开浏览器页面,但还不知道该先看哪里、怎么判断系统是不是正常,那这页就是最合适的入口。

1 分钟先看懂:Dashboard 到底是干什么的

官方文档里常见两个名字:DashboardControl UI。对大多数用户来说,可以先把它们理解成同一套浏览器控制界面。平时最常用的启动方式是:

openclaw dashboard

如果本机已经启动过 Gateway,这条命令通常会直接帮你打开浏览器页面。你不需要先把每个术语都背下来,只要先记住一件事:Dashboard 最重要的价值,是让你能同时看到会话、状态、日志和设备授权。

第一次打开以后,建议按这个顺序走

  1. 先看顶部或状态区,确认 Gateway 正在运行。
  2. 打开聊天主窗口,发送一条最简单的本地测试消息。
  3. 看左侧会话列表里有没有生成新会话。
  4. 切到 Logs,看有没有模型请求、消息路由或报错记录。
  5. 如果你已经接了渠道,再去看 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 个误区

  1. 只盯聊天窗口,不看日志:很多问题其实日志里一眼就能看出来。
  2. 把 Dashboard 当成唯一入口:它很方便,但不是替代 CLI 的全部能力。
  3. 看到新会话就以为一切正常:新会话出现只说明消息进来了,不等于模型和工具已经可用。
  4. 多个设备随便开,不做授权管理:Control UI 带控制面能力,安全上不要太随意。

如果 Dashboard 打不开,先这样查

openclaw gateway status
openclaw status --deep
openclaw logs --follow

这三步通常比“直接重装”更有效。如果是远程访问问题,再看设备授权和当前令牌,而不是一上来改 workspace 或重配模型。

建议搭配阅读

官方参考