openclaw doctor

Gateway 和频道的健康检查 + 快速修复。

相关文档:

示例

openclaw doctor
openclaw doctor --repair
openclaw doctor --deep

注意事项:

  • 交互式提示(如钥匙串/OAuth 修复)仅在 stdin 是 TTY 且设置 --non-interactive 时运行。无头运行(cron、Telegram、无终端)会跳过提示。
  • --fix--repair 的别名)会将备份写入 ~/.openclaw/openclaw.json.bak,并移除未知的配置键,逐个列出移除项。
  • 状态完整性检查现在能检测会话目录中的孤立对话记录文件,并可将它们归档为 .deleted.<timestamp> 以安全回收空间。
  • Doctor 还会扫描 ~/.openclaw/cron/jobs.json(或 cron.store)中的旧版定时任务格式,并在调度器运行时自动规范化之前就地重写。
  • Doctor 包含记忆搜索就绪检查,当 embedding 凭据缺失时会建议运行 openclaw configure --section model
  • 如果启用了沙盒模式但 Docker 不可用,doctor 会报告一个高优先级警告并给出修复建议(安装 Dockeropenclaw config set agents.defaults.sandbox.mode off)。

macOS:launchctl 环境变量覆盖

如果你之前运行过 launchctl setenv OPENCLAW_GATEWAY_TOKEN ...(或 ...PASSWORD),该值会覆盖配置文件,可能导致持续的”未授权”错误。

launchctl getenv OPENCLAW_GATEWAY_TOKEN
launchctl getenv OPENCLAW_GATEWAY_PASSWORD

launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD