所有文章
OpenClaw「Access Not Configured」錯誤:快速修復指南

OpenClaw「Access Not Configured」錯誤:快速修復指南

|2 分鐘閱讀

嘗試使用 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(終端機介面)連線逾時了。這會在以下情況發生:

  1. TUI 開啟時 gateway 被停止
  2. 系統進入睡眠模式
  3. 網路連線中斷

修復方法: 直接重新啟動:

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 模式,不需要裝置配對——只需部署並打開瀏覽器。

準備好部署 OpenClaw 了嗎?

不需要 Docker、SSH、DevOps。不到 1 分鐘即可部署。

免費開始使用