openclaw/docs/cli/doctor.md

summary	read_when
CLI reference for `clawdbot doctor` (health checks + guided repairs)	You have connectivity/auth issues and want guided fixes You updated and want a sanity check

clawdbot doctor

Health checks + quick fixes for the gateway and channels.

Related:

• Troubleshooting: Troubleshooting
• Security audit: Security

Examples

clawdbot doctor
clawdbot doctor --repair
clawdbot doctor --deep

macOS: launchctl env overrides

If you previously ran launchctl setenv CLAWDBOT_GATEWAY_TOKEN ... (or ...PASSWORD), that value overrides your config file and can cause persistent “unauthorized” errors.

launchctl getenv CLAWDBOT_GATEWAY_TOKEN
launchctl getenv CLAWDBOT_GATEWAY_PASSWORD

launchctl unsetenv CLAWDBOT_GATEWAY_TOKEN
launchctl unsetenv CLAWDBOT_GATEWAY_PASSWORD