简要总结
Dashboard
这页是教你打开和进入一个叫“控制面板”的魔法屏幕。这个屏幕就像你玩具的遥控器,可以让你指挥一个叫“网关”的电脑小助手。我们会在什么时候看这页呢?当你想用浏览器打开这个控制面板,或者它不让你进去、显示“没权限”的时候,就可以来这里找办法。
五岁小孩版解释
这个控制面板是一个用浏览器打开的屏幕,专门给管理员用的,就像爸爸妈妈的手机解锁后能用的高级功能。它默认的地址是 http://127.0.0.1:18789/。要记住哦:这个屏幕很重要,不要随便让外面的人看到,最好只在你自己的电脑上,或者通过安全的通道(比如 Tailscale 或 SSH 隧道)来使用。
最方便的打开方法(推荐)
- 第一次设置后:完成初始设置后,命令行工具会自动帮你打开控制面板,并给你一个干净的链接。
- 之后想再打开:在命令行里输入
openclaw dashboard这个命令。它会帮你复制链接,并尝试打开浏览器。如果你的电脑没有屏幕,它还会告诉你用 SSH 的方法。 - 如果需要密码:如果屏幕提示你要输入密码,你就去找到
gateway.auth.token这个密码(或者叫OPENCLAW_GATEWAY_TOKEN的环境变量),把它粘贴到控制面板的设置里。
关于“密码”的小知识(本地和远程)
- 在自己电脑上玩:直接打开
http://127.0.0.1:18789/这个地址就行。 - 密码从哪里来:密码通常写在
gateway.auth.token这个设置里。openclaw dashboard命令有时会把这个密码偷偷藏在网址里帮你一次开门,但控制面板自己不会记住这个密码。 - 如果密码被藏起来了:有时候密码被放在一个秘密保险箱里(这叫 SecretRef)。这时
openclaw dashboard命令给你的网址里就不会有密码,这是为了保护密码安全,不让它出现在别的地方。 - 去别人电脑上玩:如果你想去控制另一台电脑的网关,就不能直接用上面的地址了。你需要用一些安全通道,比如 Tailscale Serve(如果设置允许,可以不用密码)、或者建立一个 SSH 隧道。
如果屏幕说“没权限”或者“1008”
别着急,我们可以一步一步检查:
- 先检查能不能找到网关小助手:
- 如果它在你自己电脑上,运行
openclaw status命令看看它是不是在。 - 如果它在别的电脑上,你需要先建立一个“隧道”。在命令行输入
ssh -N -L 18789:127.0.0.1:18789 user@host(把user@host换成那台电脑的用户名和地址),然后再打开http://127.0.0.1:18789/。
- 如果它在你自己电脑上,运行
- 找到正确的密码:
- 如果密码就写在配置文件里,运行
openclaw config get gateway.auth.token命令看看密码是什么。 - 如果密码被藏在秘密保险箱里(SecretRef),你需要先去那个保险箱把密码拿出来,或者在你现在的命令行窗口里设置一个叫
OPENCLAW_GATEWAY_TOKEN的环境变量来放密码,然后再运行一次openclaw dashboard命令。 - 如果根本没有设置密码,运行
openclaw doctor --generate-gateway-token命令,它会帮你生成一个。
- 如果密码就写在配置文件里,运行
- 把密码交给控制面板:拿到密码后,在控制面板的设置页面里,找到输入密码的地方,把密码粘贴进去,然后点击连接。