OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Web interfaces

儀表板

閘道儀表板是預設由 / 提供服務的瀏覽器控制介面（可使用 gateway.controlUi.basePath 覆寫）。

快速開啟（本機閘道）：

重要參考資料：

系統會在 WebSocket 交握期間，透過已設定的閘道驗證路徑強制執行驗證：

  • connect.params.auth.token
  • connect.params.auth.password
  • 當 gateway.auth.allowTailscale: true 時，使用 Tailscale Serve 身分識別標頭
  • 當 gateway.auth.mode: "trusted-proxy" 時，使用受信任 Proxy 身分識別標頭

請參閱閘道設定中的 gateway.auth。

快速方式（建議）

  • 完成初始設定後，命令列介面會自動開啟儀表板，並顯示不含權杖的乾淨連結。
  • 隨時重新開啟：openclaw dashboard（複製連結、盡可能開啟瀏覽器，若為無頭環境則顯示 SSH 提示）。
  • 如果剪貼簿和瀏覽器傳遞都失敗，openclaw dashboard 仍會顯示乾淨的 URL，並指示你將權杖（取自 OPENCLAW_GATEWAY_TOKEN 或 gateway.auth.token）附加為 URL 片段鍵 token；它絕不會在日誌中顯示權杖值。
  • 如果介面提示輸入共用密鑰驗證，請將已設定的權杖或密碼貼到控制介面設定中。

驗證基礎（本機與遠端）

  • Localhost：開啟 http://127.0.0.1:18789/。
  • 閘道 TLS：當 gateway.tls.enabled: true 時，儀表板／狀態連結會使用 https://，而控制介面的 WebSocket 連結會使用 wss://。
  • 共用密鑰權杖來源：gateway.auth.token（或 OPENCLAW_GATEWAY_TOKEN）。openclaw dashboard 可透過 URL 片段傳遞權杖以進行一次性啟動；控制介面會依目前的分頁及所選的閘道 URL，將權杖保留在 sessionStorage，而不是 localStorage。
  • 缺少設定時的執行階段權杖：如果啟動訊息指出已產生執行階段權杖，該權杖是暫時性的，無法透過 openclaw config get gateway.auth.token 取得。回送介面仍需要驗證。請執行 openclaw doctor --generate-gateway-token、重新啟動閘道，然後將已設定的權杖貼到控制介面設定中。
  • 如果 gateway.auth.token 由 SecretRef 管理，為避免在 Shell 日誌、剪貼簿歷程或瀏覽器啟動引數中暴露外部管理的權杖，openclaw dashboard 依設計會顯示、複製並開啟不含權杖的 URL。如果目前的 Shell 無法解析該參照，它仍會顯示不含權杖的 URL，以及可據以執行的驗證設定指引。
  • 共用密鑰密碼：使用已設定的 gateway.auth.password（或 OPENCLAW_GATEWAY_PASSWORD）。儀表板不會在重新載入後保留密碼。
  • 具身分識別資訊的模式：當 gateway.auth.allowTailscale: true 時，Tailscale Serve 會透過身分識別標頭滿足控制介面／WebSocket 驗證；非回送且可感知身分識別的反向 Proxy 會滿足 gateway.auth.mode: "trusted-proxy"。兩者的 WebSocket 都不需要貼上共用密鑰。
  • 非 localhost：請使用 Tailscale Serve、非回送共用密鑰繫結、搭配 gateway.auth.mode: "trusted-proxy" 的非回送身分識別感知反向 Proxy，或 SSH 通道。除非你刻意執行私人輸入流量的 gateway.auth.mode: "none" 或受信任 Proxy HTTP 驗證，否則 HTTP API 仍會使用共用密鑰驗證。請參閱 Web 介面。

在 Telegram 中開啟

Telegram Bot 可使用 /dashboard，將儀表板開啟為 Telegram Mini App。

需求：

  • gateway.tailscale.mode: "serve" 或 "funnel"，以便 Telegram 取得 HTTPS Mini App URL。
  • Telegram 傳送者必須是 Bot 擁有者：即 commands.ownerAllowFrom 中的數字 Telegram 使用者 ID，或所選帳號的有效 channels.telegram.allowFrom。
  • 在與 Bot 的私訊中執行 /dashboard。在群組中叫用時，只會指示你在私訊中開啟該命令，不會包含按鈕。
  • Docker 安裝：Serve/Funnel 模式要求閘道在 tailscaled 旁繫結回送介面，而使用已發布連接埠的橋接網路無法滿足此需求。請使用 network_mode: host 執行閘道容器，並將主機的 tailscaled Socket（/var/run/tailscale）及 tailscale 命令列介面掛載至容器中。

Mini App 會執行一次性的擁有者交接，並使用短效啟動權杖重新導向至控制介面。它不會在 URL 中暴露共用閘道權杖。

v1 不涵蓋的目標：

  • 不支援 Telegram Web iframe。
  • Tailscale Serve/Funnel 是唯一受支援的已發布 URL 路徑。

如果看到 “unauthorized”／1008

  • 確認閘道可連線：本機使用 openclaw status；遠端則建立 SSH 通道 ssh -N -L 18789:127.0.0.1:18789 user@gateway-host，然後開啟 http://127.0.0.1:18789/。
  • 對於 AUTH_TOKEN_MISMATCH，當閘道傳回重試提示時，用戶端可使用快取的裝置權杖進行一次受信任的重試；該次重試會重複使用權杖中快取且已核准的範圍（明確的 deviceToken／scopes 呼叫端會保留其要求的範圍集合）。如果該次重試後驗證仍失敗，請手動解決權杖偏移問題。
  • 對於 AUTH_SCOPE_MISMATCH，系統已識別裝置權杖，但它未包含所要求的範圍；請重新配對或核准新的範圍集合，而非輪替共用閘道權杖。
  • 在該重試路徑之外，連線驗證的優先順序為：明確指定的共用權杖／密碼、明確指定的 deviceToken、已儲存的裝置權杖，最後是啟動權杖。
  • 在非同步 Tailscale Serve 路徑中，系統會先將相同 {scope, ip} 的失敗嘗試依序處理，再由驗證失敗限制器記錄，因此第二個同時發生的錯誤重試可能已顯示 retry later。
  • 權杖偏移修復步驟請參閱權杖偏移復原檢查清單。
  • 從閘道主機取得或提供共用密鑰：
    • 權杖：openclaw config get gateway.auth.token
    • 密碼：解析已設定的 gateway.auth.password 或 OPENCLAW_GATEWAY_PASSWORD
    • SecretRef 管理的權杖：解析外部密鑰提供者，或在此 Shell 中匯出 OPENCLAW_GATEWAY_TOKEN，然後重新執行 openclaw dashboard
    • 因未設定共用密鑰而產生的執行階段權杖：執行 openclaw doctor --generate-gateway-token、重新啟動閘道，然後使用已設定的權杖
  • 在儀表板設定中，將權杖或密碼貼到驗證欄位，然後連線。
  • 介面語言選擇器位於 Settings -> General -> Language，而非 Appearance 下方。

相關內容

Was this useful?
On this page

On this page