> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 儀表板

# `openclaw dashboard`

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw dashboard
openclaw dashboard --no-open
openclaw dashboard --json
openclaw dashboard --yes
```

* `--no-open`：輸出 URL，但不啟動瀏覽器。
* `--json`：輸出一個機器可讀的連線物件，不開啟瀏覽器、不使用剪貼簿、不顯示提示，也不啟動閘道。
* `--yes`：需要時直接啟動／安裝閘道，不顯示提示。

## 機器可讀輸出

桌面整合與需要已解析控制介面 URL 的指令碼，請使用 `--json`：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw dashboard --json
```

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

注意事項：

* 盡可能解析已設定的 `gateway.auth.token` SecretRef。
* 遵循 `gateway.tls.enabled`：啟用 TLS 的閘道會輸出／開啟 `https://` 控制介面 URL，並透過 `wss://` 連線。
* 對於 `lan` 或萬用字元 `custom` 繫結，同一主機上的啟動一律使用迴路位址，因為萬用字元不是瀏覽器目的地。純文字 `tailnet` 和 `custom` 繫結也會使用 `127.0.0.1`，讓瀏覽器具有安全內容；啟用 TLS 的特定主機則保留設定的位址，以符合憑證名稱。
* 在為特定介面繫結提供經過驗證的迴路 URL 之前，命令會探測設定的介面，並確認該介面與 `127.0.0.1` 由同一個閘道程序擁有。若接聽程式的擁有權不明確，將以失敗關閉方式處理，並提供狀態指引。
* 對於由 SecretRef 管理的權杖（無論已解析或未解析），輸出、複製或開啟的 URL 絕不會包含權杖，因此外部密鑰不會洩漏至終端輸出、剪貼簿歷程記錄或瀏覽器啟動引數中。
* 如果 `gateway.auth.token` 由 SecretRef 管理但尚未解析，命令會輸出不含權杖的 URL 與修正指引，而不是無效的權杖預留位置。
* 如果需要權杖驗證的 URL 無法透過剪貼簿／瀏覽器提供，命令會記錄安全的手動驗證提示，其中會提及 `OPENCLAW_GATEWAY_TOKEN`、`gateway.auth.token` 與 URL 片段索引鍵 `token`，但不會輸出權杖值。

## 相關內容

* [命令列介面參考](/zh-TW/cli)
* [儀表板](/zh-TW/web/dashboard)