OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Dashboard

这页是教你打开和进入一个叫“控制面板”的魔法屏幕。这个屏幕就像你玩具的遥控器,可以让你指挥一个叫“网关”的电脑小助手。我们会在什么时候看这页呢?当你想用浏览器打开这个控制面板,或者它不让你进去、显示“没权限”的时候,就可以来这里找办法。

五岁小孩版解释

这个控制面板是一个用浏览器打开的屏幕,专门给管理员用的,就像爸爸妈妈的手机解锁后能用的高级功能。它默认的地址是 http://127.0.0.1:18789/要记住哦:这个屏幕很重要,不要随便让外面的人看到,最好只在你自己的电脑上,或者通过安全的通道(比如 Tailscale 或 SSH 隧道)来使用。

最方便的打开方法(推荐)

  1. 第一次设置后:完成初始设置后,命令行工具会自动帮你打开控制面板,并给你一个干净的链接。
  2. 之后想再打开:在命令行里输入 openclaw dashboard 这个命令。它会帮你复制链接,并尝试打开浏览器。如果你的电脑没有屏幕,它还会告诉你用 SSH 的方法。
  3. 如果需要密码:如果屏幕提示你要输入密码,你就去找到 gateway.auth.token 这个密码(或者叫 OPENCLAW_GATEWAY_TOKEN 的环境变量),把它粘贴到控制面板的设置里。

关于“密码”的小知识(本地和远程)

  • 在自己电脑上玩:直接打开 http://127.0.0.1:18789/ 这个地址就行。
  • 密码从哪里来:密码通常写在 gateway.auth.token 这个设置里。openclaw dashboard 命令有时会把这个密码偷偷藏在网址里帮你一次开门,但控制面板自己不会记住这个密码。
  • 如果密码被藏起来了:有时候密码被放在一个秘密保险箱里(这叫 SecretRef)。这时 openclaw dashboard 命令给你的网址里就不会有密码,这是为了保护密码安全,不让它出现在别的地方。
  • 去别人电脑上玩:如果你想去控制另一台电脑的网关,就不能直接用上面的地址了。你需要用一些安全通道,比如 Tailscale Serve(如果设置允许,可以不用密码)、或者建立一个 SSH 隧道。

如果屏幕说“没权限”或者“1008”

别着急,我们可以一步一步检查:

  1. 先检查能不能找到网关小助手
    • 如果它在你自己电脑上,运行 openclaw status 命令看看它是不是在。
    • 如果它在别的电脑上,你需要先建立一个“隧道”。在命令行输入 ssh -N -L 18789:127.0.0.1:18789 user@host(把 user@host 换成那台电脑的用户名和地址),然后再打开 http://127.0.0.1:18789/
  2. 找到正确的密码
    • 如果密码就写在配置文件里,运行 openclaw config get gateway.auth.token 命令看看密码是什么。
    • 如果密码被藏在秘密保险箱里(SecretRef),你需要先去那个保险箱把密码拿出来,或者在你现在的命令行窗口里设置一个叫 OPENCLAW_GATEWAY_TOKEN 的环境变量来放密码,然后再运行一次 openclaw dashboard 命令。
    • 如果根本没有设置密码,运行 openclaw doctor --generate-gateway-token 命令,它会帮你生成一个。
  3. 把密码交给控制面板:拿到密码后,在控制面板的设置页面里,找到输入密码的地方,把密码粘贴进去,然后点击连接。