診斷與修復：使用 openclaw doctor 快速搞定 Gateway 問題
每次設定環境最怕遇到那種「昨天還好好的，今天突然動不了」的情況。你檢查了幾遍 config，確認了 API Key，但 Gateway 還是報錯。這種時候，與其自己瞎猜，不如讓工具幫你掃描一遍。
我們開發了 openclaw doctor 指令，專門用來處理這種讓人抓狂的時刻。它能幫你檢查 Gateway 和各個 Channel 的健康狀態，甚至能直接幫你修復一些常見的設定錯誤。
需要準備的東西
Section titled “需要準備的東西”在開始診斷之前，請確保你已經：
- 安裝並設定好 OpenClaw
- 擁有至少一個正在運行的 Gateway 或 Channel
如果你覺得 Gateway 怪怪的，直接執行下面這行指令。這是最基本的健康檢查：
openclaw doctor如果你想讓它自動幫你修復發現的問題，可以加上 --repair（或者用別名 --fix）。這個操作很安全，它會先把你的設定檔備份到 ~/.openclaw/openclaw.json.bak，然後移除掉那些無效或未知的設定項。
openclaw doctor --repair如果你需要更徹底的掃描，可以使用深度檢查模式：
openclaw doctor --deep關於互動式提示
Section titled “關於互動式提示”有一點要注意：如果 openclaw doctor 需要你輸入資訊（例如修復 Keychain 或 OAuth 授權），它只會在你的終端機（TTY）是互動式的情況下執行。如果你是在 cron、Telegram 或其他無頭（headless）環境下執行，並加上了 --non-interactive 參數，這些需要互動的修復步驟會被自動跳過。
macOS 使用者的環境變數陷阱
Section titled “macOS 使用者的環境變數陷阱”如果你在 macOS 上遇到持續的「unauthorized」錯誤，但 config 檔看起來沒問題，那可能是你之前用 launchctl 設定過環境變數。這些變數的優先級高於設定檔，會覆蓋掉你的正確設定。
你可以先檢查是否有這些殘留的變數：
launchctl getenv OPENCLAW_GATEWAY_TOKENlaunchctl getenv OPENCLAW_GATEWAY_PASSWORD如果真的有值，請執行以下指令清除它們：
launchctl unsetenv OPENCLAW_GATEWAY_TOKENlaunchctl unsetenv OPENCLAW_GATEWAY_PASSWORD清除後再次執行 openclaw doctor 看看問題是否解決。
如果你遇到更複雜的疑難雜症，可以詢問 AI Setup Assistant 獲取即時協助。
OpenClaw Expert
還是卡住了？
如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。