Discord Doctor

快速诊断并修复Discord机器人、网关、OAuth令牌及旧版配置问题。检查连接性、令牌过期情况,并清理旧的Clawdis残留文件。

安装

概览

Discord Doctor 是一款专为 Discord 机器人及网关环境设计的诊断与修复工具,旨在快速识别并解决常见的 Discord 连接、OAuth 令牌失效以及旧版配置冲突问题。该工具通过系统化的检查流程,覆盖从 Discord 桌面应用状态到 Clawdbot 网关进程运行状况的多个关键维度,帮助开发者迅速定位故障点。当检测到问题时,Discord Doctor 还能自动执行修复操作,例如启动缺失的网关服务、安装必要的 npm 依赖包、清理遗留的 launchd 服务文件,甚至备份旧的 Clawdis 配置文件,从而大幅降低手动排查和修复的时间成本。无论是刚完成升级的用户,还是遭遇 OAuth 令牌过期或网关无响应的开发者,都可以借助这一工具实现一键式健康检查与环境修复。

核心功能特点

  1. 全面检测 Discord 桌面应用、网关进程、HTTP 端口连通性及实际 Discord 连接状态
  2. 自动验证 Anthropic OAuth 令牌有效性,识别过期或无效凭证并提供重新认证指引
  3. 智能识别并清理旧版 Clawdis 的残留 launchd 服务和配置文件,避免升级冲突
  4. 支持一键自动修复功能,包括启动网关、安装 npm 依赖、重启服务与备份历史配置
  5. 实时显示最近 Discord 活动记录,辅助判断会话活跃度和异常断开情况

适用场景

Discord Doctor 特别适用于那些使用 Clawdbot 或基于 Clawdis 构建的 Discord 机器人项目用户。在日常运维中,若遇到机器人突然无法响应命令、网关长时间离线或 OAuth 登录提示频繁出现,运行 `discord-doctor` 可立即获得详细的健康报告,快速确认是网络问题、服务未启动还是令牌失效所致。对于已从旧版本 Clawdis 迁移至 Clawdbot 的用户,该工具能有效检测并移除可能导致身份验证混乱的遗留配置文件和系统服务,确保新环境干净稳定。此外,在开发调试阶段,开发者可通过定期执行诊断命令监控网关运行状态,并结合 `–fix` 参数自动化处理常见问题,显著提升部署效率和系统可靠性。无论是个人项目维护还是团队协作管理,Discord Doctor 都能成为保障 Discord 机器人持续在线的关键助手。