← 返回 Skills 市场
wehub4me

Discord Roster

作者 wehub4me · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ 安全检测通过
169
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install discord-roster
功能描述
Query Discord guild members, list bots, get channel and role info via REST API. Use when: listing server members, checking who's a bot, viewing channel permi...
使用说明 (SKILL.md)

Discord Roster

Inspect Discord guilds: members, bots, channels, roles. Read-only queries via REST API.

Setup

The script scripts/discord-roster.sh handles everything. It reads the bot token from ~/.openclaw/openclaw.json and auto-detects proxy settings.

Usage

bash skills/discord-roster/scripts/discord-roster.sh \x3Ccommand> [args...]

Commands

List guild members (most common):

# All members
bash skills/discord-roster/scripts/discord-roster.sh members \x3Cguild_id>

# Bots only
bash skills/discord-roster/scripts/discord-roster.sh members \x3Cguild_id> --bots

# Humans only
bash skills/discord-roster/scripts/discord-roster.sh members \x3Cguild_id> --humans

Get channel info:

bash skills/discord-roster/scripts/discord-roster.sh channel \x3Cchannel_id>

List guild channels:

bash skills/discord-roster/scripts/discord-roster.sh channels \x3Cguild_id>

List guild roles:

bash skills/discord-roster/scripts/discord-roster.sh roles \x3Cguild_id>

Look up which guild a channel belongs to:

bash skills/discord-roster/scripts/discord-roster.sh guild-of \x3Cchannel_id>

Output

All commands output clean, tab-separated text for easy parsing. Example for members:

TYPE    USERNAME        DISPLAY_NAME    ID                  JOINED_AT           ROLES
BOT     my-bot          —               1234567890123456789 2026-01-15T10:30    9876543210987654321
BOT     helper-bot      —               2345678901234567890 2026-01-15T10:31    —
HUMAN   johndoe         John            3456789012345678901 2026-01-15T10:25    —

Proxy

The script checks for proxy in this order:

  1. channels.discord.proxy in openclaw.json
  2. HTTPS_PROXY / https_proxy env var
  3. Direct connection (no proxy)

Troubleshooting

  • 403 Forbidden: Bot lacks SERVER MEMBERS INTENT — enable in Discord Developer Portal > Bot > Privileged Gateway Intents.
  • Unknown Guild: Bot isn't in that guild. Invite it first.
  • Connection timeout: Check proxy settings. Discord requires external network access.
安全使用建议
This skill appears to do what it says: run read-only Discord API queries using a bot token stored in ~/.openclaw/openclaw.json (or a path set via OPENCLAW_CONFIG). Before installing: 1) ensure you trust the skill source and that your bot token is stored only where you intend (the script will read that file); 2) confirm you have curl and python3 available (the script uses both, but the metadata didn't list them); 3) make sure the bot token has only the permissions you want (and enable Server Members Intent if you need member lists); and 4) if ~/.openclaw/openclaw.json contains other secrets, consider putting the Discord token in a dedicated location or restrict that file's contents to minimize accidental exposure.
功能分析
Type: OpenClaw Skill Name: discord-roster Version: 1.0.2 The discord-roster skill provides read-only auditing capabilities for Discord servers, including listing members, roles, and channels. The script scripts/discord-roster.sh correctly retrieves the required bot token from the standard OpenClaw configuration path and interacts only with the official Discord API (discord.com/api/v10). No evidence of data exfiltration, credential theft, or malicious execution was found.
能力评估
Purpose & Capability
The skill's purpose (querying Discord guild members, channels, roles) matches the script's behavior: it uses a bot token to call Discord REST endpoints. Minor mismatch: the package/registry metadata declares no required binaries, but the script clearly calls curl and python3.
Instruction Scope
SKILL.md and the script confine actions to read-only Discord API GET requests and proxy detection; the script reads the bot token from ~/.openclaw/openclaw.json (or OPENCLAW_CONFIG if set) and may consult HTTPS_PROXY environment variables—all consistent with the stated purpose.
Install Mechanism
Instruction-only skill with an included shell script; there is no install step that downloads or executes external code. No high-risk install mechanisms detected.
Credentials
Declared required config path is channels.discord.token (appropriate). The script also honors OPENCLAW_CONFIG and HTTPS_PROXY/https_proxy environment variables; these are reasonable but were not listed in required env vars. No unrelated credentials are requested.
Persistence & Privilege
The skill does not request permanent/always inclusion and does not modify other skills or system-wide settings; it only reads the local OpenClaw config file for the token and proxy.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install discord-roster
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /discord-roster 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
- No changes detected in this version. - All functionality and documentation remain the same as the previous release.
v1.0.1
- Updated SKILL.md with new example output for the `members` command. - No changes to scripts or functionality; documentation and sample output only.
v1.0.0
Initial release of discord-roster. - Query Discord guild members, with options to list all, only bots, or only humans. - Retrieve detailed info on channels, list all channels or roles, and determine a channel’s guild via REST API. - Outputs clean, tab-separated text for easy scripting and analysis. - Supports proxy auto-detection via config or environment variables. - Includes a troubleshooting section for common setup issues.
元数据
Slug discord-roster
版本 1.0.2
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

Discord Roster 是什么?

Query Discord guild members, list bots, get channel and role info via REST API. Use when: listing server members, checking who's a bot, viewing channel permi... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 169 次。

如何安装 Discord Roster?

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

Discord Roster 是免费的吗?

是的,Discord Roster 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Discord Roster 支持哪些平台?

Discord Roster 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Discord Roster?

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

💬 留言讨论