Dashboard（Control UI）

Gateway dashboard 是預設在 / 提供的瀏覽器 Control UI，可在本機透過 http://127.0.0.1:18789/ 存取。

Gateway dashboard 是預設在 / 提供的瀏覽器 Control UI（可透過 gateway.controlUi.basePath 覆寫）。

快速開啟（本機 Gateway）：

• http://127.0.0.1:18789/（或 http://localhost:18789/）

重要參考：

• Control UI 了解使用方式與 UI 功能。
• Tailscale 了解 Serve/Funnel 自動化。
• Web surfaces 了解繫結模式與安全性注意事項。

認證在 WebSocket 交握時透過 connect.params.auth（token 或 password）強制執行。請參閱 Gateway configuration 中的 gateway.auth。

安全性注意事項：Control UI 是一個管理介面（聊天、設定、執行核准）。請勿公開暴露。UI 在首次載入後會將 token 儲存在 localStorage 中。建議使用 localhost、Tailscale Serve 或 SSH 通道。

快速路徑（建議）

• 入門完成後，CLI 會自動開啟 dashboard 並印出一個乾淨的（無 token 的）連結。
• 隨時重新開啟：openclaw dashboard（複製連結、如可能則開啟瀏覽器、如為無頭環境則顯示 SSH 提示）。
• 如果 UI 提示認證，請從 gateway.auth.token（或 OPENCLAW_GATEWAY_TOKEN）貼上 token 至 Control UI 設定。

Token 基礎（本機 vs 遠端）

• Localhost：開啟 http://127.0.0.1:18789/。
• Token 來源：gateway.auth.token（或 OPENCLAW_GATEWAY_TOKEN）；UI 在您連線後會在 localStorage 中儲存一份副本。
• 非 localhost：使用 Tailscale Serve（當 gateway.auth.allowTailscale: true 時，Control UI/WebSocket 無需 token，假設 gateway 主機受信任；HTTP API 仍需要 token/password）、tailnet bind 搭配 token，或 SSH 通道。請參閱 Web surfaces。

如果出現「unauthorized」/ 1008

• 確保 gateway 可連線（本機：openclaw status；遠端：SSH 通道 ssh -N -L 18789:127.0.0.1:18789 user@host 然後開啟 http://127.0.0.1:18789/）。
• 從 gateway 主機取得 token：openclaw config get gateway.auth.token（或產生一個：openclaw doctor --generate-gateway-token）。
• 在 dashboard 設定中，將 token 貼入認證欄位，然後連線。