openclaw doctor

Gateway 和頻道的健康檢查與快速修復。

相關資源:

範例

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 Dockeropenclaw 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