名称： discord-doctor
描述： Discord 机器人、Gateway、OAuth 令牌及旧版配置问题的快速诊断与修复。检查连接性、令牌过期情况，并清理旧的 Clawdis 残留文件。
元数据： {"clawdbot":{"emoji":"🩺","os":["darwin","linux"],"requires":{"bins":["node","curl"]}}}

Discord Doctor

快速诊断和修复 Discord/Gateway 可用性问题、OAuth 令牌问题以及旧版 Clawdis 配置冲突。

使用方法

# 仅检查状态（诊断模式）
discord-doctor

# 检查并自动修复问题
discord-doctor --fix

检查项目

1. Discord 应用 - Discord 桌面应用是否正在运行（可选，用于监控）
2. Gateway 进程 - Clawdbot 网关守护进程是否正在运行
3. Gateway HTTP - 网关是否在端口 18789 上响应
4. Discord 连接 - 机器人是否实际连接到 Discord（通过 clawdbot health 检查）
5. Anthropic OAuth - 您的 OAuth 令牌是否有效或已过期
6. 旧版 Clawdis - 检测可能导致冲突的旧版 launchd 服务和配置目录
7. 近期活动 - 显示最近的 Discord 会话记录

自动修复功能

使用 --fix 参数运行时，可以：

• 启动网关（如果未运行）
• 安装缺失的 npm 包（如 discord.js、strip-ansi）
• 修复依赖项后重启网关
• 移除旧版 launchd 服务（com.clawdis.gateway.plist）
• 备份旧版配置（将 ~/.clawdis 移动到 ~/.clawdis-backup）

常见问题与修复

OAuth 令牌问题

如果看到“访问令牌已过期”，请运行：

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
正在检查 Discord 和 Gateway 运行状况...

1. Discord 应用
   正在运行（6 个进程）

2. Gateway 进程
   正在运行（PID: 66156，运行时间: 07:45）

3. Gateway HTTP
   在端口 18789 上正常响应

4. Discord 连接
   Discord: 正常 (@Clawdis) (321ms)

5. Anthropic OAuth
   有效（将在 0 小时 45 分钟后过期）

6. 旧版 Clawdis
   未发现旧版 launchd 服务
   未发现旧版配置目录

7. 近期 Discord 活动
   - discord:group:123456789012345678 (21 小时前)

总结
所有检查通过！Discord 运行状况良好。