Discord App - Is the Discord desktop app running (optional, for monitoring)
Gateway Process - Is the Clawdbot gateway daemon running
Gateway HTTP - Is the gateway responding on port 18789
Discord Connection - Is the bot actually connected to Discord (via clawdbot health)
Anthropic OAuth - Is your OAuth token valid or expired
Legacy Clawdis - Detects old launchd services and config directories that cause conflicts
Recent Activity - Shows recent Discord sessions

Auto-Fix Capabilities

When run with --fix, it can:

Start gateway if not running
Install missing npm packages (like discord.js, strip-ansi)
Restart gateway after fixing dependencies
Remove legacy launchd service (com.clawdis.gateway.plist)
Backup legacy config (moves ~/.clawdis to ~/.clawdis-backup)

Common Issues & Fixes

Issue	Auto-Fix Action
Gateway not running	Starts gateway on port 18789
Missing npm packages	Runs `npm install` + installs specific package
Discord disconnected	Restarts gateway to reconnect
OAuth token expired	Shows instructions to re-authenticate
Legacy launchd service	Removes old `com.clawdis.gateway.plist`
Legacy ~/.clawdis config	Moves to `~/.clawdis-backup`

OAuth Token Issues

If you see "Access token EXPIRED", run:

cd ~/Clawdis && npx clawdbot configure

Then select "Anthropic OAuth (Claude Pro/Max)" to re-authenticate.

Legacy Clawdis Migration

If you upgraded from Clawdis to Clawdbot, you may have legacy artifacts causing OAuth token conflicts:

Old launchd service: ~/Library/LaunchAgents/com.clawdis.gateway.plist
Old config directory: ~/.clawdis/

Run discord-doctor --fix to clean these up automatically.

Example Output

Discord Doctor
Checking Discord and Gateway health...

1. Discord App
   Running (6 processes)

2. Gateway Process
   Running (PID: 66156, uptime: 07:45)

3. Gateway HTTP
   Responding on port 18789

4. Discord Connection
   Discord: ok (@Clawdis) (321ms)

5. Anthropic OAuth
   Valid (expires in 0h 45m)

6. Legacy Clawdis
   No legacy launchd service
   No legacy config directory

7. Recent Discord Activity
   - discord:group:123456789012345678 (21h ago)

Summary
All checks passed! Discord is healthy.

discord-doctor

Discord Doctor

Usage

What It Checks