openclaw doctor
Gateway 和频道的健康检查 + 快速修复。
相关文档:
- 故障排查:Troubleshooting
- 安全审计:Security
示例
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 会报告一个高优先级警告并给出修复建议(
安装 Docker或openclaw 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