CLI commands

儀表板

openclaw dashboard

使用目前的驗證開啟控制介面。

bash
openclaw dashboardopenclaw dashboard --no-openopenclaw dashboard --jsonopenclaw dashboard --yes
  • --no-open:印出 URL,但不啟動瀏覽器。
  • --json:印出一個機器可讀的連線物件,不開啟瀏覽器、不使用剪貼簿、不顯示提示,也不啟動閘道。
  • --yes:需要時直接啟動/安裝閘道,不顯示提示。

機器可讀的輸出

對於需要已解析控制介面 URL 的桌面整合與指令碼,請使用 --json

bash
openclaw dashboard --json

回應包含 urlhttpUrlwsUrlporttokenIncluded。如果閘道尚未就緒,命令會傳回 {"ok":false,"reason":"..."},並以非零狀態結束。由 SecretRef 管理的權杖絕不會包含在 url 中。

注意事項:

  • 可能時會解析已設定的 gateway.auth.token SecretRef。
  • 遵循 gateway.tls.enabled:啟用 TLS 的閘道會印出/開啟 https:// 控制介面 URL,並透過 wss:// 連線。
  • 對於 lan 或萬用字元 custom 繫結,同一主機上的啟動一律使用迴送位址,因為萬用字元不是瀏覽器目的地。明文 tailnetcustom 繫結也會使用 127.0.0.1,讓瀏覽器具有安全內容;啟用 TLS 的特定主機則保留已設定的位址,以符合憑證名稱。
  • 在為特定介面繫結提供經過驗證的迴送 URL 前,命令會探測已設定的介面,並確認該介面與 127.0.0.1 由同一個閘道程序擁有。如果接聽器擁有權不明確,系統會採取封閉式失敗,並提供狀態指引。
  • 對於由 SecretRef 管理的權杖(無論已解析或未解析),印出、複製或開啟的 URL 都不會包含權杖,因此外部密鑰不會洩漏至終端輸出、剪貼簿歷程記錄或瀏覽器啟動引數。
  • 如果 gateway.auth.token 由 SecretRef 管理但尚未解析,命令會印出不含權杖的 URL 和修復指引,而非無效的權杖預留位置。
  • 如果權杖驗證 URL 的剪貼簿/瀏覽器傳遞失敗,命令會記錄安全的手動驗證提示,其中會指出 OPENCLAW_GATEWAY_TOKENgateway.auth.token 和 URL 片段鍵 token,但不會印出權杖值。

相關內容

Was this useful?
On this page

On this page