discord-doctor

What This Skill Does

The discord-doctor skill acts as a comprehensive diagnostic and self-healing agent for users running Clawdbot or similar Discord-integrated services. It automates the tedious troubleshooting process for common environment issues, including Gateway daemon malfunctions, OAuth token expirations, and legacy configuration conflicts inherited from previous Clawdis installations. By performing deep system checks—ranging from checking HTTP responsiveness on port 18789 to verifying Anthropic OAuth status—it reduces downtime and eliminates the need for manual debugging. With its --fix flag, the skill proactively repairs broken dependencies, wipes out problematic legacy artifacts, and initiates necessary restarts to ensure seamless connectivity.

Installation

To integrate this utility into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/kn71gxkg16twyqz5wzkvt61sh17yjnpd/discord-doctor

Use Cases

This skill is essential for developers or users who rely on local gateway processes for Discord automation. Common scenarios include:

• Troubleshooting connection drops where the bot stops responding to commands.
• Resolving "Access token EXPIRED" errors for Anthropic/Claude integration.
• Migrating legacy files from older Clawdis setups to the current Clawdbot architecture.
• Rapidly identifying missing npm dependencies after a system update.
• Performing routine health checks to ensure the gateway process is active and communicating correctly.

Example Prompts

1. "Run discord-doctor to check if my bot's gateway is healthy and currently connected to Discord."
2. "My Discord bot is offline; please use discord-doctor with the fix flag to resolve any potential configuration errors."
3. "Can you check my environment for any old Clawdis files that might be causing OAuth conflicts?"

Tips & Limitations

• Always run the diagnostic command first without flags to review the current system state before applying auto-fixes.
• If the tool reports an OAuth token expiration, remember that the auto-fix capability cannot re-authenticate you; you must follow the provided npx clawdbot configure instructions.
• The tool is designed specifically for local gateway setups on systems where Clawdbot or Clawdis was installed; it will not work on remote or cloud-hosted Discord bots. Ensure you have the necessary write permissions in your home directory, as the skill performs file-management tasks like moving configuration backups.