返回教程中心
CLI 命令参考

OpenClaw dashboard 使用教程 控制台打开和认证处理指南

O
OpenClaw AI
2026-03-25

openclaw dashboard 是打开 Dashboard 的官方 CLI 入口。很多用户觉得控制台访问只要记住 http://127.0.0.1:18789/ 就够了,但在真实部署里,这往往不够稳。因为一旦涉及:

  • 认证参数
  • 远程隧道
  • 当前运行 profile
  • 本地与远程 Gateway 混用

手动猜地址就很容易出错。

这个命令适合解决什么问题

openclaw dashboard 最适合用在这些场景:

  • 第一次打开控制台
  • 你直接访问地址时看到 unauthorized
  • 你已经建好 SSH 隧道,但不确定到底应该访问哪个链接
  • 你想让 CLI 直接给出当前可用的控制台地址

最常用的用法

bash
openclaw dashboard

在允许打开浏览器的环境里,它通常会直接帮你打开;在无头环境里,它也会输出正确的访问链接。

为什么它比手动输地址更好

因为它往往会同时帮你处理这些细节:

  • 输出当前正确的 Dashboard 访问地址
  • 在需要时拼接认证参数
  • 在支持图形环境时直接打开浏览器

这比你自己反复试:

text
http://127.0.0.1:18789/

通常更稳。

远程主机上该怎么用

如果 Gateway 跑在远程 Linux、VPS 或 Raspberry Pi 上,常见做法是:

  1. 在远程主机上先看 Dashboard 链接
  2. 在本地建立 SSH 隧道
  3. 再从本地浏览器访问

例如:

bash
ssh user@gateway-host 'openclaw dashboard --no-open'
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

然后在本机浏览器访问输出出来的链接。

--no-open 什么时候有用

当你在下面这些环境里时,--no-open 很实用:

  • 服务器
  • SSH 会话
  • 没有图形桌面的主机
  • 你只想拿到 URL,不想触发本地浏览器

这类场景下:

bash
openclaw dashboard --no-open

通常比直接运行更合适。

遇到 unauthorized 时先怎么判断

如果你手动输地址看到 unauthorized,不要先怀疑 Gateway 坏了。更常见的原因是:

  • 访问的不是正确入口
  • 认证参数缺失
  • 远程隧道没建好
  • 当前 profile 和你以为的不是同一个

这时候优先用 openclaw dashboard 重新拿一遍链接,往往比盲猜地址更快。

它和 gateway status 的区别

  • openclaw dashboard 解决“怎么进去”
  • openclaw gateway status 解决“Gateway 现在活着没”

如果你连链接都拿不准,先用 dashboard;如果链接没问题但页面打不开,再去看 gateway status 和日志。

一个推荐习惯

以后只要碰到控制台问题,先不要记忆式地手输地址。先跑:

bash
openclaw dashboard

让 CLI 给你当前正确入口,再去判断是认证、隧道还是服务状态的问题,会省很多时间。

继续阅读

相关阅读与站内入口

准备好开始了吗?

继续探索更多教程,或者去技能市场看看有哪些现成的插件。