遇到 "gateway start blocked: set gateway.mode=local (current: unset) or pass --allow-unconfigured" 錯誤了嗎？這是最常見的 OpenClaw 設定問題——而且修復起來很快。
為什麼會出現這個錯誤
OpenClaw 的 gateway 在啟動前需要明確的模式設定。這是一項安全措施：gateway 在你告訴它應該接受本地連線、遠端連線還是兩者都接受之前，不會啟動。
如果你看到以下任一訊息，都是同樣的問題：
gateway start blocked: set gateway.mode=local (current: unset)
or pass --allow-unconfigured
Missing config. Run `openclaw setup` or set gateway.mode=local
(or pass --allow-unconfigured).
gateway.mode unset — gateway start will be blocked
修復方法（30 秒）
執行這一條指令：
openclaw config set gateway.mode local
然後重啟：
openclaw restart
就是這樣。你的 gateway 應該能正常啟動了。
gateway.mode 的作用是什麼？
gateway.mode 設定控制你的 OpenClaw gateway 如何接受連線：
| 模式 | 說明 | 適用場景 |
|---|---|---|
local |
只接受來自 localhost 的連線 |
個人使用、單機設定 |
remote |
接受來自任何 IP 的連線 | 多裝置存取、反向代理設定 |
hybrid |
同時接受本地和遠端連線 | 開發 + 正式環境 |
對大多數使用者來說，local 是正確的選擇。 如果你透過反向代理（Caddy、Nginx、Traefik）存取 OpenClaw，仍然應該選擇 local，因為代理在同一台機器上運行。
那 --allow-unconfigured 呢？
--allow-unconfigured flag 是一次性的繞過方式：
openclaw gateway start --allow-unconfigured
這會在不儲存任何設定的情況下啟動 gateway。它適合快速測試，但下次重啟時你會再看到同樣的錯誤。永久設定 gateway.mode 才是更好的解決方案。
設定了 gateway.mode 後仍然被阻擋？
如果你已經設定了模式但 gateway 仍然無法啟動，檢查是否有其他缺少的設定：
# 執行診斷工具
openclaw doctor
# 自動修復所有偵測到的問題
openclaw doctor --fix
其他常見問題：
連接埠衝突：另一個程序正在使用 gateway 的連接埠
openclaw config set gateway.port 3002設定檔損壞：重設並重新設定
openclaw config validate權限問題：設定目錄無法寫入
ls -la ~/.openclaw/
驗證是否正常運作
修復後，確認 gateway 正在運行：
openclaw status
你應該會在輸出中看到 gateway: running。你也可以檢查日誌：
openclaw logs --tail 20
尋找 [gateway] listening on——這是確認就緒的訊號。
完全跳過設定步驟
如果你不想處理 gateway 設定問題，ClawTank 提供預先設定好的 OpenClaw 實例，gateway 已經設定完成。不到 1 分鐘即可部署——不需要任何終端機指令。