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 覆寫）。

快速開啟（本機閘道）：

主要參考資料：

  • 控制介面：瞭解使用方式與介面功能。
  • Tailscale：瞭解 Serve/Funnel 自動化。
  • Web 介面：瞭解繫結模式與安全性注意事項。

系統會在 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。
  • 如果 gateway.auth.token 由 SecretRef 管理，openclaw dashboard 會刻意輸出、複製及開啟不含權杖的 URL，避免在 Shell 記錄、剪貼簿歷程或瀏覽器啟動引數中暴露由外部管理的權杖。如果目前 Shell 中的參照尚未解析，它仍會輸出不含權杖的 URL，並提供可採取行動的驗證設定指引。
  • 共用密鑰密碼：使用已設定的 gateway.auth.password（或 OPENCLAW_GATEWAY_PASSWORD）。儀表板不會在重新載入後保留密碼。
  • 帶有身分的模式：當 gateway.auth.allowTailscale: true 時，Tailscale Serve 會透過身分標頭滿足控制介面／WebSocket 驗證；非 Loopback 且可辨識身分的反向 Proxy 則會滿足 gateway.auth.mode: "trusted-proxy"。兩者的 WebSocket 都不需要貼上共用密鑰。
  • 非 localhost：請使用 Tailscale Serve、非 Loopback 的共用密鑰繫結、設定了 gateway.auth.mode: "trusted-proxy" 的非 Loopback 身分感知反向 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 或所選帳號有效的 channels.telegram.allowFrom 中所列的數字 Telegram 使用者 ID。
  • 在與 Bot 的私人訊息中執行 /dashboard。在群組中叫用時，只會提示你在私人訊息中開啟該命令，不會包含按鈕。
  • Docker 安裝：Serve/Funnel 模式要求閘道在 tailscaled 旁繫結 Loopback，使用已發佈連接埠的橋接網路無法滿足此要求。請以 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