Discord 连接诊断
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-discord-doctor。
技能介绍
要解决的问题
跑 Clawdbot 接 Discord 时,失败往往藏在多层状态里:本机 gateway 没起来、18789 端口无响应、bot 实际未连上 Discord、Anthropic OAuth 过期,或从 Clawdis 升级后残留的 launchd 与 ~/.clawdis 还在抢配置。手动逐项查进程、npm 依赖和 token 很耗时间,且容易漏掉旧服务冲突。
技能如何工作
Discord Doctor 按固定清单做连通性体检,并在带 --fix 时尝试自动修复常见故障。
检查项包括:
- Gateway 进程 与 HTTP(默认端口
18789)是否可用 - 通过
clawdbot health判断 Discord 连接是否真实在线 - Anthropic OAuth 是否有效(含过期提示)
- Legacy Clawdis:如
com.clawdis.gateway.plist、~/.clawdis等冲突源 - 可选关注桌面 Discord App 与近期会话活动
--fix 时可:启动或重启 gateway、为缺失包装执行 npm install(如 discord.js、strip-ansi)、移除旧 launchd 服务、将 ~/.clawdis 备份迁移到 ~/.clawdis-backup。OAuth 过期时会给出重新选择「Anthropic OAuth (Claude Pro/Max)」认证的指引,而非盲目改配置。
适用边界
这是 Clawdbot / OpenClaw 生态下的本地诊断与修复助手,不是 Discord 官方支持工具。自动修复覆盖文档中列出的网关、依赖与遗留配置场景;token 过期通常仍需你按提示完成重新登录。若问题在 Discord 开发者后台权限、Bot Token 类型或云端网络策略,需要结合 Discord 与部署环境另行排查。
使用场景
- 本机 Clawdbot gateway 未启动,需要确认 18789 端口与 bot 是否已连上 Discord
- 终端报 Access token EXPIRED,要区分 OAuth 问题还是 gateway/依赖故障
- 从 Clawdis 迁到 Clawdbot 后 bot 连不上,怀疑旧 launchd 或 ~/.clawdis 仍在生效
- npm 缺 discord.js 等包导致 gateway 异常,希望一键补依赖并重启服务
适合人员
- 维护 OpenClaw/Clawdbot 网关、经常在 macOS 上用 launchd 跑 Discord 集成的自建部署者
- 接入 Anthropic OAuth 的 Claude Pro/Max 用户,需要在 token 过期时快速定位认证链路
- 从 Clawdis 升级 Clawdbot 的维护者,要清理 com.clawdis.gateway.plist 与旧配置目录
- 负责 Discord bot 联调的前端/全栈工程师,希望用统一清单而不是手工查进程和端口