A specialized diagnostic and automated repair utility designed to maintain healthy Discord bot connections and resolve configuration conflicts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install discord-doctor
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install discord-doctor using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is discord-doctor?
The discord-doctor skill serves as a vital maintenance tool for developers utilizing Discord integrations. It provides a comprehensive suite of health checks to identify common points of failure, including inactive gateway processes, port 18789 responsiveness, and expired Anthropic OAuth tokens. By integrating this skill into your Openclaw Skills workflow, you can ensure high availability for your AI agents.
Beyond simple diagnostics, the tool is purpose-built to handle the transition from legacy setups to modern architectures. It automatically detects and remediates conflicts caused by old Clawdis artifacts, such as outdated launchd services or redundant configuration directories, ensuring that your environment remains clean and optimized for performance.
discord-doctor Use Cases
- Troubleshooting persistent bot disconnects or gateway timeout errors.
- Detecting and renewing expired Anthropic OAuth tokens before they disrupt service.
- Migrating legacy environments to the latest Openclaw Skills standards.
- Automating the installation of missing npm dependencies required for Discord communication.
- Auditing recent session activity to debug specific connectivity windows.
How discord-doctor Works
- The skill initiates a multi-point scan of the local environment to detect running Discord desktop apps and gateway daemons.
- It tests the Gateway HTTP interface on port 18789 to confirm the service is responding to requests.
- A health check is triggered via the clawdbot CLI to verify that the bot is successfully authenticated and connected to Discord.
- The utility inspects OAuth metadata to determine the time remaining before token expiration.
- If the fix flag is enabled, the skill executes a sequence of remediation steps, including service restarts and legacy file migration.
discord-doctor Setup
To utilize this skill, ensure that you have Node.js and curl installed on your macOS or Linux system. You can execute the diagnostic or repair commands directly from your terminal:
# Run a status check to identify issues
discord-doctor
# Run the auto-fix utility to resolve identified problems
discord-doctor --fix
If the tool identifies an expired OAuth token, you may need to re-authenticate manually within your Openclaw Skills environment:
cd ~/Clawdis && npx clawdbot configure
discord-doctor Data Schema & Taxonomy
The skill manages connectivity metadata and system configuration states as follows:
| Component | Detail |
|---|---|
| Gateway Port | Port 18789 |
| Legacy Config | ~/.clawdis/ (Moved to backup during fix) |
| Backup Directory | ~/.clawdis-backup/ |
| Service Manager | launchd (com.clawdis.gateway.plist) |
| Dependencies | node, curl, discord.js, strip-ansi |
discord-doctor Advanced Features
- Automated recovery of the gateway daemon if the process is found to be terminated.
- Intelligent cleanup of legacy launchd services to prevent configuration drift within Openclaw Skills.
- Real-time dependency injection to install missing npm packages without manual intervention.
- Detailed session auditing that displays recent Discord activity and uptime statistics.
SKILL.md
Loading
Related Openclaw Skills
Workout Logger
A conversational fitness assistant that tracks your workouts, calculates personal records, and provides data-driven exercise suggestions.
Weight Loss
A privacy-centric weight tracking tool that focuses on long-term trends, milestone achievements, and non-scale victories using locally stored data.
Testosterone Optimization
A data-driven protocol tracker to naturally optimize testosterone levels through sleep, nutrition, and compound lifting.
Study Habits
A sophisticated learning companion that utilizes cognitive science to optimize information retention through spaced repetition and active recall.
Cydew Agent Onboarding
A specialized integration skill for automating AI agent registration, pricing configuration, and profile management on the Cydew marketplace.
Apollo.io API Connector
A professional-grade integration for the Apollo.io REST API, enabling automated people search, organization enrichment, and B2B data retrieval.
Featured*
