discord-doctor_skill

This skill quickly diagnoses and repairs Discord bot connectivity, OAuth token, and legacy config issues, keeping your Clawdbot running smoothly.

Python

2.5k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill discord-doctor

_meta.json282 B
SKILL.md2.9 KB

Overview

This skill provides quick diagnosis and automated repairs for Discord bot connectivity, gateway availability, OAuth token validity, and legacy Clawdis configuration conflicts. It runs a series of checks and can optionally auto-fix common problems to get your Clawdbot instance back online. The tool is lightweight and intended for local troubleshooting and migration assistance.

How this skill works

The skill runs a checklist: it inspects the Discord desktop app state, verifies the Clawdbot gateway process and its HTTP port (18789), and queries the bot connection via clawdbot health. It validates Anthropic OAuth tokens, reports recent Discord sessions, and detects legacy Clawdis launchd services and config directories. When invoked with --fix, it can start or restart the gateway, install missing npm packages, remove legacy launchd plists, and back up old configuration folders.

When to use it

When the bot fails to connect to Discord or shows frequent disconnects
After upgrading from Clawdis to Clawdbot to remove legacy artifacts
When OAuth authentication errors indicate an expired or invalid token
If the gateway process isn’t running or the gateway HTTP endpoint is unresponsive
Before filing a bug report to collect a focused set of diagnostics

Best practices

Run diagnostic mode first (discord-doctor) to review issues before applying fixes
Use discord-doctor --fix only on systems where you control the gateway and config files
Back up custom gateway configurations separately; discord-doctor moves legacy ~/.clawdis to a backup folder
Re-authenticate via npx clawdbot configure when token expiration is reported
Keep Node/npm updated so dependency installs succeed

Example use cases

Quickly confirm gateway health and bot connectivity after a restart or deploy
Automatically repair missing npm dependencies that prevent the gateway from starting
Clean up old launchd service and ~/.clawdis config after migrating from Clawdis to Clawdbot
Detect and prompt re-authentication when Anthropic OAuth tokens are expired

FAQ

No. The fixer avoids deleting active Clawdbot config. It moves legacy ~/.clawdis to ~/.clawdis-backup and removes old launchd plists that conflict with Clawdbot.

How do I refresh an expired OAuth token?

Run: cd ~/Clawdis && npx clawdbot configure then choose Anthropic OAuth to re-authenticate. discord-doctor will report token status and prompt this when needed.