跳转至

openclaw dashboard

使用短时效的一次性所有者配对链接打开 Control UI。成功交接后,该签名浏览器会获得持久的管理员设备凭据,因此重新打开 dashboard 不再依赖共享 Gateway token。在同一浏览器中打开新的交接,也可以修复先前受限的设备凭据。

openclaw dashboard
openclaw dashboard --no-open
openclaw dashboard --json
openclaw dashboard --yes
  • --no-open:打印 URL,但不启动浏览器。
  • --json:打印一个机器可读的连接对象,且不打开浏览器、使用剪贴板、提示或启动 Gateway。
  • --yes:在需要时启动/安装 Gateway,而不提示。

网关服务与状态兼容性

OpenClaw CLI 和后台 Gateway 服务是相互独立的。服务安装提示指的是所选 profile 的后台服务;它并不意味着 CLI 缺失。dashboard 需要一个正在运行的 Gateway,该 Gateway 也可以在终端中运行。

如果配置的端口被占用,但无法验证其 Gateway 握手,dashboard 会报告检查失败,并且不会提供启动另一个服务的选项。运行 openclaw gateway status --deep 以检查监听器并修复其连接。

较新的数据库 schema 警告表示当前构建版本无法读取现有状态。请使用与该状态兼容的构建版本。若要重新开始,请将 OPENCLAW_STATE_DIR 指向一个单独的目录。安装后台服务无法解决数据库版本不匹配问题。参见数据库兼容性。

机器可读输出

对于需要解析后的 Control UI URL 的桌面集成和脚本,请使用 --json:

openclaw dashboard --json

响应包括向后兼容的共享认证 url,以及 browserUrl、browserBootstrapExpiresAtMs、httpUrl、wsUrl、port 和 tokenIncluded。浏览器集成应打开 browserUrl;需要共享 Gateway 凭据的原生 RPC 客户端可继续使用 url。如果 Gateway 未就绪或无法发出浏览器交接,命令返回 {"ok":false,"reason":"..."} 并以非零状态退出。SecretRef 管理的共享 token 永远不会包含在 url 中。

对于终端 HTTP 失败,无法读取的修复诊断会将观察到的 HTTP 状态保留在 reason 中(例如,HTTP 503)。

说明:

  • 在可能时解析已配置的 gateway.auth.token SecretRefs。
  • browserUrl 在 URL fragment 中携带一次性的十分钟 bootstrap。Control UI 会立即移除它,将其绑定到浏览器的签名设备身份,并仅存储由此产生的管理员每设备凭据。另一个浏览器 profile 无法继承或重放该授权。
  • 配对链接包含其 Gateway 目标。如果在浏览器中选择了另一个 Gateway,请在配对前确认目标;取消会保留现有选择。当 Gateway 更新在配对完成前重新加载 dashboard 时,也适用此规则。
  • 遵循 gateway.tls.enabled:启用 TLS 的 gateway 会打印/打开 https:// Control UI URL,并通过 wss:// 连接。
  • 对于 lan 或通配符 custom 绑定,同主机启动始终使用 loopback,因为通配符不是浏览器目标。明文 tailnet 和 custom 绑定也使用 127.0.0.1,以便浏览器拥有安全上下文;启用 TLS 的特定主机保留配置地址,以便证书名称匹配。
  • 在为特定接口绑定交付经过身份验证的 loopback URL 之前,命令会检查配置的接口,并验证该接口和 127.0.0.1 由同一个 Gateway 进程拥有。如果监听器所有权不明确,命令会安全失败并给出状态指导。
  • 交互式命令仅打印干净的 base URL;剪贴板/浏览器启动接收一次性的 browserUrl,而不是共享 token。因此,SecretRef 管理的共享 token 不会泄漏到终端输出、剪贴板历史或浏览器启动参数中。
  • 如果 token 认证的 URL 的剪贴板/浏览器交付失败,命令会记录一条安全的手动认证提示,其中指明 OPENCLAW_GATEWAY_TOKEN、gateway.auth.token 和 URL fragment 键 token,而不会打印 token 值。
  • 如果共享 token 无法放入 URL,并且剪贴板/浏览器交付失败,请运行 openclaw dashboard --json,并在十分钟内打开其短时效的 browserUrl。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw