openclaw/docs/zh-CN/cli/doctor.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
遇到连接/认证问题并需要引导修复 更新后想要进行安装完整性检查	`openclaw doctor` 的 CLI 参考（健康检查 + 引导修复）	doctor	generated_at model provider source_hash source_path workflow 2026-02-01T19:58:59Z claude-opus-4-5 pi 92310aa3f3d111e91a74ce1150359d5d8a8d70a856666d9419e16c60d78209f2 cli/doctor.md 14

openclaw doctor

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

相关内容：

• 故障排除：故障排除
• 安全审计：安全

示例

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

备注：

• 交互式提示（如钥匙串/OAuth 修复）仅在 stdin 为 TTY 且未设置 --non-interactive 时运行。无头运行（cron、Telegram、无终端）将跳过提示。
• --fix（--repair 的别名）会将备份写入 ~/.openclaw/openclaw.json.bak，并删除未知的配置键，同时列出每个删除项。

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