Skill

discord-doctor

From sundial-org-awesome-openclaw-skills-4

Diagnoses and auto-fixes Discord bot gateway connectivity, OAuth token expiration, and legacy Clawdis config issues. Checks Discord app status, process, HTTP endpoint, bot health, and recent activity.

Node

Install

npx claudepluginhub joshuarweaver/cascade-ai-ml-agents-misc-2 --plugin sundial-org-awesome-openclaw-skills-4

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Quick diagnosis and repair for Discord/Gateway availability issues, OAuth token problems, and legacy Clawdis configuration conflicts.

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Stars586

Forks75

Last CommitFeb 1, 2026

Actions

View Source View Plugin View on GitHub View README

Discord Doctor

Quick diagnosis and repair for Discord/Gateway availability issues, OAuth token problems, and legacy Clawdis configuration conflicts.

Usage

# Check status (diagnostic only)
discord-doctor

# Check and auto-fix issues
discord-doctor --fix

What It Checks

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.