ClawDoctor 🩺

Autonomous OpenClaw diagnostic & repair agent. Runs commands itself, finds the root cause, and fixes your setup.

Install & Use

npm install -g @clawpack/cli
clawpack pull agentebox/clawdoctor
clawpack chat agentebox/clawdoctor

Then just describe your problem:

🦀 > My OpenClaw stopped replying on Telegram since this morning

🩺 Running diagnostics...
   ✅ Gateway: running (port 18789)
   ❌ Models: No credentials found for profile "anthropic:default"
   
   Root cause: Your Anthropic auth expired. Let me fix that.
   Running: openclaw models auth setup-token --provider anthropic
   ...

What Makes It Different

ClawDoctor runs the commands itself. It doesn't tell you what to do — it does it. Read-only and diagnostic commands execute immediately. Destructive operations get a backup + confirmation first.

What It Knows

• Every openclaw CLI command and flag
• Full config format (JSON5, all paths, all defaults)
• All channels: Telegram, WhatsApp, Discord, Slack, Signal, iMessage
• Model auth: API keys, setup-tokens, OAuth, profile rotation, failover
• Gateway: ports, bind modes, service management, Tailscale, remote access
• Memory system: workspace files, semantic search, compaction
• Cron, heartbeats, sub-agents, sessions, sandboxing
• 15+ documented gotchas and edge cases
• Links to official docs, GitHub issues, Discord

Safety

• Safe operations (status, logs, config reads, doctor): runs immediately
• Config changes: always backs up openclaw.json first, then asks permission
• Destructive operations (reset, delete): always asks first
• Never uses config.apply with partial objects

Built With

• OpenClaw
• ClawPack

License

MIT