openclaw dashboard 是打开 Dashboard 的官方 CLI 入口。很多用户觉得控制台访问只要记住 http://127.0.0.1:18789/ 就够了,但在真实部署里,这往往不够稳。因为一旦涉及:
- 认证参数
- 远程隧道
- 当前运行 profile
- 本地与远程 Gateway 混用
手动猜地址就很容易出错。
这个命令适合解决什么问题
openclaw dashboard 最适合用在这些场景:
- 第一次打开控制台
- 你直接访问地址时看到
unauthorized - 你已经建好 SSH 隧道,但不确定到底应该访问哪个链接
- 你想让 CLI 直接给出当前可用的控制台地址
最常用的用法
openclaw dashboard
在允许打开浏览器的环境里,它通常会直接帮你打开;在无头环境里,它也会输出正确的访问链接。
为什么它比手动输地址更好
因为它往往会同时帮你处理这些细节:
- 输出当前正确的 Dashboard 访问地址
- 在需要时拼接认证参数
- 在支持图形环境时直接打开浏览器
这比你自己反复试:
http://127.0.0.1:18789/
通常更稳。
远程主机上该怎么用
如果 Gateway 跑在远程 Linux、VPS 或 Raspberry Pi 上,常见做法是:
- 在远程主机上先看 Dashboard 链接
- 在本地建立 SSH 隧道
- 再从本地浏览器访问
例如:
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,不想触发本地浏览器
这类场景下:
openclaw dashboard --no-open
通常比直接运行更合适。
遇到 unauthorized 时先怎么判断
如果你手动输地址看到 unauthorized,不要先怀疑 Gateway 坏了。更常见的原因是:
- 访问的不是正确入口
- 认证参数缺失
- 远程隧道没建好
- 当前 profile 和你以为的不是同一个
这时候优先用 openclaw dashboard 重新拿一遍链接,往往比盲猜地址更快。
它和 gateway status 的区别
openclaw dashboard解决“怎么进去”openclaw gateway status解决“Gateway 现在活着没”
如果你连链接都拿不准,先用 dashboard;如果链接没问题但页面打不开,再去看 gateway status 和日志。
一个推荐习惯
以后只要碰到控制台问题,先不要记忆式地手输地址。先跑:
openclaw dashboard
让 CLI 给你当前正确入口,再去判断是认证、隧道还是服务状态的问题,会省很多时间。