Discord Doctor 是一款针对 Discord 机器人运行环境的诊断与修复工具，主要解决 Discord/Gateway 可用性问题、OAuth 令牌问题以及旧版 Clawdis 配置冲突。
用途 该工具用于快速检查 Discord 机器人与 Clawdbot 网关的健康状况，并在发现问题时提供自动修复能力，适合从 Clawdis 升级到 Clawdbot 后遇到配置或令牌冲突的用户。
主要能力 诊断检查以下项目：Discord 桌面应用是否运行（可选，用于监控）；网关进程（Clawdbot gateway 守护进程）是否运行；网关 HTTP 是否在端口 18789 上响应；机器人是否实际连接到 Discord（通过 clawdbot health）；Anthropic OAuth 令牌是否有效或已过期；检测造成冲突的旧版 Clawdis launchd 服务和配置目录；显示最近的 Discord 会话活动。
使用方式 仅诊断：执行命令 discord-doctor 诊断并自动修复：执行命令 discord-doctor --fix
自动修复能力（使用 --fix 时） 启动未运行的网关；安装缺失的 npm 包（如 discord.js、strip-ansi）；修复依赖后重启网关；移除旧版 launchd 服务（com.clawdis.gateway.plist）；备份旧版配置（将 ~/.clawdis 移动到 ~/.clawdis-backup）。
常见问题与修复动作 网关未运行：在端口 18789 上启动网关；缺失 npm 包：运行 npm install 并安装指定包；Discord 断开连接：重启网关以重新连接；OAuth 令牌过期：显示重新认证的说明；旧版 launchd 服务：移除旧的 com.clawdis.gateway.plist；旧版 ~/.clawdis 配置：移动到 ~/.clawdis-backup。
OAuth 令牌问题 如果看到“Access token EXPIRED”，运行： cd ~/Clawdis && npx clawdbot configure 然后选择“Anthropic OAuth (Claude Pro/Max)”重新认证。
旧版 Clawdis 迁移 如果从 Clawdis 升级到 Clawdbot，可能存在导致 OAuth 令牌冲突的遗留产物：旧 launchd 服务位于 ~/Library/LaunchAgents/com.clawdis.gateway.plist，旧配置目录位于 ~/.clawdis/。运行 discord-doctor --fix 可自动清理。
示例输出 Discord Doctor Checking Discord and Gateway health...
-
Discord App Running (6 processes)
-
Gateway Process Running (PID: 66156, uptime: 07:45)
-
Gateway HTTP Responding on port 18789
-
Discord Connection Discord: ok (@Clawdis) (321ms)
-
Anthropic OAuth Valid (expires in 0h 45m)
-
Legacy Clawdis No legacy launchd service No legacy config directory
-
Recent Discord Activity
- discord:group:123456789012345678 (21h ago)
Summary All checks passed! Discord is healthy.
适用场景 适用于运行 Clawdbot 网关并连接 Discord 的 macOS 用户，尤其适合排查网关无法启动、机器人掉线、OAuth 令牌过期，以及从 Clawdis 升级后遗留服务与配置目录引发的冲突。
限制 现有资料未说明支持的平台范围（除 macOS launchd 相关路径外）、版本要求、收费方式或价格信息；未提供更详细的依赖条件、卸载方式或除上述检查项与修复动作之外的其他功能。