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