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

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