/install discord-doctor
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
~/.clawdisto~/.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.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install discord-doctor - 安装完成后,直接呼叫该 Skill 的名称或使用
/discord-doctor触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2205 次。
如何安装 Discord Doctor?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install discord-doctor」即可一键安装,无需额外配置。
Discord Doctor 是免费的吗?
是的,Discord Doctor 完全免费(开源免费),可自由下载、安装和使用。
Discord Doctor 支持哪些平台?
Discord Doctor 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin, linux)。
谁开发了 Discord Doctor?
由 jhillock(@jhillock)开发并维护,当前版本 v1.0.0。