Agent Skills
返回列表
💻

Discord 连接诊断

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 联调的前端/全栈工程师,希望用统一清单而不是手工查进程和端口