← 返回 Skills 市场
jhillock

Discord Doctor

作者 jhillock · GitHub ↗ · v1.0.0
darwinlinux ⚠ suspicious
2205
总下载
1
收藏
2
当前安装
1
版本数
在 OpenClaw 中安装
/install discord-doctor
功能描述
Quick diagnosis and repair for Discord bot, Gateway, OAuth token, and legacy config issues. Checks connectivity, token expiration, and cleans up old Clawdis artifacts.
使用说明 (SKILL.md)

Discord Doctor

Quick diagnosis and repair for Discord/Gateway availability issues, OAuth token problems, and legacy Clawdis configuration conflicts.

Usage

# Check status (diagnostic only)
discord-doctor

# Check and auto-fix issues
discord-doctor --fix

What It Checks

  1. Discord App - Is the Discord desktop app running (optional, for monitoring)
  2. Gateway Process - Is the Clawdbot gateway daemon running
  3. Gateway HTTP - Is the gateway responding on port 18789
  4. Discord Connection - Is the bot actually connected to Discord (via clawdbot health)
  5. Anthropic OAuth - Is your OAuth token valid or expired
  6. Legacy Clawdis - Detects old launchd services and config directories that cause conflicts
  7. Recent Activity - Shows recent Discord sessions

Auto-Fix Capabilities

When run with --fix, it can:

  • Start gateway if not running
  • Install missing npm packages (like discord.js, strip-ansi)
  • Restart gateway after fixing dependencies
  • Remove legacy launchd service (com.clawdis.gateway.plist)
  • Backup legacy config (moves ~/.clawdis to ~/.clawdis-backup)

Common Issues & Fixes

Issue Auto-Fix Action
Gateway not running Starts gateway on port 18789
Missing npm packages Runs npm install + installs specific package
Discord disconnected Restarts gateway to reconnect
OAuth token expired Shows instructions to re-authenticate
Legacy launchd service Removes old com.clawdis.gateway.plist
Legacy ~/.clawdis config Moves to ~/.clawdis-backup

OAuth Token Issues

If you see "Access token EXPIRED", run:

cd ~/Clawdis && npx clawdbot configure

Then select "Anthropic OAuth (Claude Pro/Max)" to re-authenticate.

Legacy Clawdis Migration

If you upgraded from Clawdis to Clawdbot, you may have legacy artifacts causing OAuth token conflicts:

  • Old launchd service: ~/Library/LaunchAgents/com.clawdis.gateway.plist
  • Old config directory: ~/.clawdis/

Run discord-doctor --fix to clean these up automatically.

Example Output

Discord Doctor
Checking Discord and Gateway health...

1. Discord App
   Running (6 processes)

2. Gateway Process
   Running (PID: 66156, uptime: 07:45)

3. Gateway HTTP
   Responding on port 18789

4. Discord Connection
   Discord: ok (@Clawdis) (321ms)

5. Anthropic OAuth
   Valid (expires in 0h 45m)

6. Legacy Clawdis
   No legacy launchd service
   No legacy config directory

7. Recent Discord Activity
   - discord:group:123456789012345678 (21h ago)

Summary
All checks passed! Discord is healthy.
安全使用建议
This skill appears to be a local repair tool for Clawdbot/Clawdis and largely does what it says, but exercise caution before installing or letting it run autonomously. Specific things to consider before use: - The SKILL.md will perform destructive actions (remove ~/Library/LaunchAgents/com.clawdis.gateway.plist, move ~/.clawdis to a backup) and start/stop processes — ensure you have backups and understand those changes. - It runs npm install / npx at runtime, which can download and execute code from the network; prefer to run these commands yourself in a controlled environment first so you can inspect what will be installed. - Registry metadata is inconsistent (top-level metadata says no required binaries, embedded SKILL.md metadata requires node and curl). Confirm the runtime requirements and where commands will be executed (which directory, global vs project). - There is no source or homepage to audit. If you need to trust this behavior, ask the publisher for source code or run the SKILL.md steps manually on a test machine/VM before enabling autonomous invocation. - If you decide to use it, run initially without --fix to review diagnostics, and only run --fix after verifying the exact actions and confirming they are safe.
功能分析
Type: OpenClaw Skill Name: discord-doctor Version: 1.0.0 The skill is classified as suspicious due to its declared high-risk capabilities, even though they are transparently stated and aligned with the diagnostic and repair purpose. Specifically, the `SKILL.md` indicates the ability to perform system file modifications (removing `~/Library/LaunchAgents/com.clawdis.gateway.plist`, moving `~/.clawdis` to `~/.clawdis-backup`), install software (`npm install` for missing packages), and access/check sensitive OAuth tokens. While these actions are described as part of auto-fix capabilities, they represent meaningful high-risk behaviors that prevent a benign classification.
能力评估
Purpose & Capability
Name/description (Discord/Clawdbot diagnosis and cleanup) align with the checks and fixes described in SKILL.md. However registry metadata at the top says no required binaries/env, while the SKILL.md metadata declares required binaries (node, curl) — a mismatch. No source/homepage is provided, reducing auditability.
Instruction Scope
SKILL.md instructs the agent to inspect processes, check a local gateway (port 18789), run `clawdbot health`, interact with local config (~/.clawdis and ~/Clawdis), remove a launchd plist, move config directories, start/restart the gateway, and run `npx clawdbot configure`. These actions are coherent with its purpose but are destructive and potentially sensitive (file deletion/moves, process restarts, exposing local tokens). The instructions are vague about confirmation prompts, exact working directories for npm installs, and safety checks.
Install Mechanism
There is no install spec for the skill itself (instruction-only), but the runtime instructions call `npm install` and `npx`, which will download and execute packages from the network. That runtime download/execute behavior increases risk because it can fetch arbitrary code at the time the skill runs. The SKILL.md also references installing packages like discord.js and strip-ansi without scoping where or how (global vs project).
Credentials
The skill declares no required environment variables or credentials, which is proportionate. However it will read and act on local configuration and OAuth tokens stored by Clawdbot/Clawdis (e.g., suggesting `npx clawdbot configure` to re-authenticate). Access to local token files/config is expected for the purpose but is sensitive; the skill does not declare or document exactly which files it will read.
Persistence & Privilege
The skill does not request always:true and has no install spec, so it does not demand permanent system presence. Autonomous invocation is allowed (platform default) but that alone is not a decisive risk. The SKILL.md's auto-fix behavior can modify user files and start/stop services, which are significant privileges at runtime but are within the stated repair scope.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install discord-doctor
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /discord-doctor 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: diagnose and repair Discord bot, Gateway, OAuth token, and legacy Clawdis config issues
元数据
Slug discord-doctor
版本 1.0.0
许可证
累计安装 2
当前安装数 2
历史版本数 1
常见问题

Discord Doctor 是什么?

Quick diagnosis and repair for Discord bot, Gateway, OAuth token, and legacy config issues. Checks connectivity, token expiration, and cleans up old Clawdis artifacts. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2205 次。

如何安装 Discord Doctor?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install discord-doctor」即可一键安装,无需额外配置。

Discord Doctor 是免费的吗?

是的,Discord Doctor 完全免费(开源免费),可自由下载、安装和使用。

Discord Doctor 支持哪些平台?

Discord Doctor 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin, linux)。

谁开发了 Discord Doctor?

由 jhillock(@jhillock)开发并维护,当前版本 v1.0.0。

💬 留言讨论