Agent skill · software engineering · sundial-org
discord-doctor
Quick diagnosis and repair for Discord bot, Gateway, OAuth token, and legacy config issues. Checks connectivity, token expiration, and cleans up old Clawdis artifacts.
Why this skill is useful
Adds executable scripts for diagnosing and fixing Discord bot issues, including OAuth token management and legacy configuration cleanup.
What it needs
Requires curl, node installed locally. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Discord Doctor Quick diagnosis and repair for Discord/Gateway availability issues, OAuth token problems, and legacy Clawdis configuration conflicts. Usage What It Checks 1. Discord App - Is the Discord desktop app running (optional, for monitoring) 2. Gateway Process - Is the Clawdbot gateway daemon running 3. Gateway HTTP - Is the gateway responding on port 18789 4. Discord Connection - Is the bot actually connected to Discord (via clawdbot health) 5. Anthropic OAuth - Is your OAuth token valid or expired 6. Legacy Clawdis - Detects old launchd services and config directories that cause conflicts 7. 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: 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
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/discord-doctor