核心功能
discord-doctor 是一款针对 Discord 机器人生态的专用诊断工具，主要面向使用 Clawdbot（前身为 Clawdis）框架的开发者。它通过 7 项关键检查快速定位故障点：Discord 桌面端运行状态、Gateway 守护进程、HTTP 端口响应、实际 Discord 连接、Anthropic OAuth 令牌有效性、遗留 Clawdis 配置冲突，以及近期活动记录。
显著优点
一站式诊断：单命令完成从进程到网络、从认证到配置的全链路检测，输出结构化报告。智能修复：--fix 模式可自动启动 Gateway、安装缺失 npm 包（如 discord.js）、清理旧版 launchd 服务与配置目录，显著降低运维门槛。迁移友好：专为 Clawdis 升级用户设计，自动备份并移除冲突性遗留文件（~/.clawdis → ~/.clawdis-backup），避免 OAuth 令牌混乱。
潜在局限
生态绑定：深度耦合 Clawdbot/Clawdis 特定架构，通用 Discord bot（如直接使用 discord.js 独立部署）难以受益。平台限制：仅支持 macOS (darwin) 与 Linux，Windows 用户无法原生使用。Token 管理被动：OAuth 过期仅提示重新认证，无法自动刷新令牌。权限依赖：修复操作需 node/npm 环境及 LaunchAgents 目录写权限，沙盒环境可能受限。
适合人群
- 使用 Clawdbot 框架的 Discord 机器人开发者
- 从 Clawdis 迁移至 Clawdbot 需清理遗留配置的用户
- 需要快速排查 Gateway 连接与 OAuth 认证问题的运维人员
常规风险
--fix的自动包安装可能拉取未锁定的依赖版本，建议生产环境先 review- 备份操作若遇磁盘满或权限问题可能中断，需手动确认
~/.clawdis-backup完整性 - 工具依赖本地 node 运行时，版本兼容性需自行校验