openclaw doctor
Gateway 和頻道的健康檢查與快速修復。
相關資源:
- 疑難排解:Troubleshooting
- 安全性稽核:Security
範例
openclaw doctor
openclaw doctor --repair
openclaw doctor --deep
注意事項:
- 互動式提示(如 keychain/OAuth 修復)僅在 stdin 為 TTY 且未設定
--non-interactive時執行。無頭執行環境(cron、Telegram、無終端機)會跳過提示。 --fix(--repair的別名)會將備份寫入~/.openclaw/openclaw.json.bak,並移除未知的設定鍵,逐一列出每個移除項目。- 狀態完整性檢查現在會偵測 sessions 目錄中的孤立轉錄檔案,並可將它們歸檔為
.deleted.<timestamp>以安全地回收空間。 - Doctor 也會掃描
~/.openclaw/cron/jobs.json(或cron.store)中的舊版 cron 任務格式,並可在排程器於執行時自動正規化之前就地改寫。 - Doctor 包含記憶體搜尋就緒檢查,並可在缺少嵌入憑證時建議執行
openclaw configure --section model。 - 如果啟用了沙箱模式但 Docker 不可用,doctor 會報告高信號的警告並提供修正建議(
install Docker或openclaw config set agents.defaults.sandbox.mode off)。
macOS:launchctl 環境變數覆蓋
如果你之前執行過 launchctl setenv OPENCLAW_GATEWAY_TOKEN ...(或 ...PASSWORD),該值會覆蓋你的設定檔,並可能導致持續的「unauthorized」錯誤。
launchctl getenv OPENCLAW_GATEWAY_TOKEN
launchctl getenv OPENCLAW_GATEWAY_PASSWORD
launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD