Awesome-openclaw-skills 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.

install

source · Clone the upstream repo

git clone https://github.com/sundial-org/awesome-openclaw-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/discord-doctor" ~/.claude/skills/sundial-org-awesome-openclaw-skills-discord-doctor && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/discord-doctor" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-discord-doctor && rm -rf "$T"

manifest: skills/discord-doctor/SKILL.md

source content

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.