← Back to Skills Marketplace
169
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install discord-roster
Description
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...
README (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:
channels.discord.proxyin openclaw.jsonHTTPS_PROXY/https_proxyenv var- 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.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install discord-roster - After installation, invoke the skill by name or use
/discord-roster - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 169 downloads so far.
How do I install Discord Roster?
Run "/install discord-roster" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Discord Roster free?
Yes, Discord Roster is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Discord Roster support?
Discord Roster is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Discord Roster?
It is built and maintained by wehub4me (@wehub4me); the current version is v1.0.2.
More Skills