嘗試使用 OpenClaw 的 dashboard 或瀏覽器介面時出現 「access not configured」?這表示 gateway 尚未設定接受網頁連線。以下是修復方法。
錯誤訊息
你可能會看到以下任一訊息:
OpenClaw: access not configured.
Error: web login provider is not available.
Device identity required.
TUI gateway disconnected — closed idle.
這些都指向同一個根本原因:gateway 需要先進行設定,才能接受瀏覽器或 API 連線。
快速修復
步驟 1:設定 Gateway 模式
openclaw config set gateway.mode local
步驟 2:重新啟動
openclaw restart
步驟 3:核准你的裝置
在瀏覽器中打開 dashboard URL,你會看到一個配對請求。核准它:
openclaw devices list
openclaw devices approve DEVICE_ID
完成。Dashboard 現在應該可以正常使用了。
「Web Login Provider Is Not Available」
這個特定錯誤表示基於網頁的驗證未啟用。修復方法:
openclaw config set gateway.mode local
openclaw restart
如果你是從其他機器存取:
openclaw config set gateway.mode remote
openclaw config set gateway.host "0.0.0.0"
openclaw restart
「Device Identity Required」
每個新的瀏覽器連線都需要核准。這是一個安全功能。
# 查看待核准的裝置
openclaw devices list
# 核准裝置
openclaw devices approve DEVICE_ID
如果你是透過 Telegram 連線,核准方式不同:
openclaw pairing approve telegram CODE
「TUI Gateway Disconnected — Closed Idle」
TUI(終端機介面)連線逾時了。這會在以下情況發生:
- TUI 開啟時 gateway 被停止
- 系統進入睡眠模式
- 網路連線中斷
修復方法: 直接重新啟動:
openclaw restart
然後重新開啟 TUI:
openclaw tui
Dashboard 可載入但顯示空白畫面
如果 dashboard URL 可以載入,但頁面是空的或顯示載入中的旋轉圖示:
檢查 1:Gateway 是否在運行
openclaw status
尋找 gateway: running。如果已停止:
openclaw gateway start
檢查 2:等待完全啟動
Gateway 需要最多 40 秒才能完全就緒。檢查日誌:
openclaw logs --follow
等待看到 [gateway] listening on 後再重新整理 dashboard。
檢查 3:瀏覽器快取
清除瀏覽器對 OpenClaw dashboard URL 的快取和 cookies,然後重新載入。
檢查 4:連接埠不匹配
確認你存取的是正確的連接埠:
openclaw config get gateway.port
導航到 http://localhost:PORT(使用輸出中顯示的連接埠)。
Docker 特定的存取問題
容器在運行但 dashboard 無法存取
檢查連接埠映射:
docker port YOUR_CONTAINER_ID
確認 gateway 連接埠已映射:
docker run -p 3001:3001 openclaw-stack
從容器外部出現「Connection refused」
Gateway 可能在容器內綁定到 127.0.0.1:
docker exec -it YOUR_CONTAINER_ID \
openclaw config set gateway.bind "0.0.0.0"
docker restart YOUR_CONTAINER_ID
執行 Doctor
不確定問題在哪裡時:
openclaw doctor --fix
這會檢查並修復:
- Gateway 模式設定
- 連接埠可用性
- 裝置配對狀態
- 設定驗證
無需繁瑣設定即可存取
ClawTank 讓你即時存取 dashboard,提供預先配置好的 HTTPS URL。不需要設定 gateway 模式,不需要裝置配對——只需部署並打開瀏覽器。
