clawdbot/docs/doctor.md

summary, read_when

summary	read_when
Doctor command: health checks, config migrations, and repair steps	Adding or modifying doctor migrations Introducing breaking config changes

Doctor

clawdbot doctor is the repair + migration tool for Clawdbot. It runs a quick health check, audits skills, and can migrate deprecated config entries to the new schema.

What it does

• Runs a health check and offers to restart the gateway if it looks unhealthy.
• Prints a skills status summary (eligible/missing/blocked).
• Detects deprecated config keys and offers to migrate them.

Legacy config migrations

When the config contains deprecated keys, other commands will refuse to run and ask you to run clawdbot doctor. Doctor will:

• Explain which legacy keys were found.
• Show the migration it applied.
• Rewrite ~/.clawdbot/clawdbot.json with the updated schema.

Current migrations:

• routing.allowFrom → whatsapp.allowFrom

Usage

clawdbot doctor

If you want to review changes before writing, open the config file first:

cat ~/.clawdbot/clawdbot.json