'修復「Gateway start blocked: set gateway.mode=local」'
當你看到 Gateway start blocked: set gateway.mode=local，代表 OpenClaw 偵測到目前的 gateway 模式不符合本機啟動要求，所以主動中止啟動。
這頁提供最短修復路徑。
這個錯誤代表什麼
Section titled “這個錯誤代表什麼”OpenClaw 預期你使用 local 模式，但目前設定可能是空值或其他模式。
常見原因：
- 舊設定或遷移後的設定未完整更新。
- 切換環境時沿用了不相容的 config。
- remote 相關設定被套用到本機流程。
請依序執行：
openclaw doctoropenclaw config get gateway.modeopenclaw config set gateway.mode localopenclaw gateway statusopenclaw logs --follow預期結果：
openclaw config get gateway.mode回傳local。openclaw gateway status顯示 runtime 正常運行。openclaw logs --follow不再重複顯示該錯誤。
如果仍然無法啟動
Section titled “如果仍然無法啟動”1) 確認目前使用的 profile/config
Section titled “1) 確認目前使用的 profile/config”若你有多個 profile，請先確認你修改的是當前生效那一份。
openclaw status --allopenclaw config get gateway.mode2) 檢查下一層阻斷訊息
Section titled “2) 檢查下一層阻斷訊息”修正 mode 後，可能會出現其他阻斷，例如：
refusing to bind gateway ... without authEADDRINUSE
可接著看：
3) 驗證端到端命令流程
Section titled “3) 驗證端到端命令流程”啟動恢復後，請在實際 channel 發一條測試命令，確認任務真的有執行。
若訊息流程不通：
OpenClaw Expert
還是卡住了？
如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。