← Back to Skills Marketplace
discord admin
by
AYMANE SALIH AIT BRAHIM
· GitHub ↗
· v1.0.0
1720
Downloads
3
Stars
4
Active Installs
1
Versions
Install in OpenClaw
/install discord-admin
Description
Complete A-Z Discord server administration. Channel/role/member management, AutoMod, webhooks, templates, audit logs, scheduled events, threads, and full server control via CLI.
README (SKILL.md)
Discord Server Admin (Pro)
A complete, enterprise-grade Discord server management skill. Everything a real server admin needs — from basic moderation to AutoMod, webhooks, templates, audit logs, and beyond.
🚀 Quick Start
# Set your bot token
export DISCORD_BOT_TOKEN="your-bot-token"
# Make script executable
chmod +x discord-admin.sh
# View all commands
./discord-admin.sh --help
📋 Command Reference
1. Server Intelligence
# Full server overview
./discord-admin.sh server-info \x3CguildId>
# Server vanity URL (if enabled)
./discord-admin.sh vanity-get \x3CguildId>
# Set vanity URL (requires DISCOVERABLE + boosts)
./discord-admin.sh vanity-set \x3CguildId> \x3Ccode>
# Server template operations
./discord-admin.sh template-list \x3CguildId> # List templates
./discord-admin.sh template-create \x3CguildId> \x3Cname> # Create template
./discord-admin.sh template-use \x3Ccode> # Create server from template
2. Channel Management (All Types)
# List ALL channels (organized by category)
./discord-admin.sh channel-list \x3CguildId>
# Create channels
./discord-admin.sh channel-create \x3CguildId> \x3Cname> text # Text
./discord-admin.sh channel-create \x3CguildId> \x3Cname> voice # Voice
./discord-admin.sh channel-create \x3CguildId> \x3Cname> category # Category
./discord-admin.sh channel-create \x3CguildId> \x3Cname> forum # Forum
./discord-admin.sh channel-create \x3CguildId> \x3Cname> stage # Stage
./discord-admin.sh channel-create \x3CguildId> \x3Cname> announcements # Announcement
# Edit channel (all settings)
./discord-admin.sh channel-edit \x3CguildId> \x3CchannelId> name:\x3CnewName> topic:\x3Ctopic>
./discord-admin.sh channel-edit \x3CguildId> \x3CchannelId> nsfw:true rateLimit:60
# Channel permissions
./discord-admin.sh channel-perms \x3CguildId> \x3CchannelId> # View perms
./discord-admin.sh channel-perms-set \x3CguildId> \x3CchannelId> \x3CroleId> allow:\x3Cperms> deny:\x3Cperms>
./discord-admin.sh channel-perms-overwrite \x3CguildId> \x3CchannelId> \x3CtargetId> \x3Ctype:role|user> allow:\x3Cperms> deny:\x3Cperms>
# Delete channel
./discord-admin.sh channel-delete \x3CguildId> \x3CchannelId>
# Bulk operations
./discord-admin.sh channel-prune \x3CguildId> \x3Cdays:7> # Delete unused channels
3. Role Management (Advanced)
# List all roles with hierarchy
./discord-admin.sh role-list \x3CguildId>
# Create role with full permissions
./discord-admin.sh role-create \x3CguildId> \x3Cname> color:#FF5500 permissions:ADMINISTRATOR
./discord-admin.sh role-create \x3CguildId> \x3Cname> permissions:MANAGE_CHANNELS,KICK_MEMBERS,BAN_MEMBERS
# Edit role
./discord-admin.sh role-edit \x3CguildId> \x3CroleId> name:\x3Cname> color:\x3Chex>
./discord-admin.sh role-edit \x3CguildId> \x3CroleId> hoist:true mentionable:true
./discord-admin.sh role-edit \x3CguildId> \x3CroleId> permissions:+MANAGE_MESSAGES,-ADMINISTRATOR
# Position management (hierarchy matters!)
./discord-admin.sh role-position \x3CguildId> \x3CroleId> \x3CnewPosition>
# Delete role
./discord-admin.sh role-delete \x3CguildId> \x3CroleId>
# Bulk role operations
./discord-admin.sh role-assign-bulk \x3CguildId> \x3CroleId> \x3CuserId1,userId2,...>
./discord-admin.sh role-remove-bulk \x3CguildId> \x3CroleId> \x3CuserId1,userId2,...>
# Role permission constants (comma-separated):
# ADMINISTRATOR, VIEW_AUDIT_LOG, VIEW_GUILD_INSIGHTS, MANAGE_GUILD, MANAGE_ROLES, MANAGE_CHANNELS, KICK_MEMBERS, BAN_MEMBERS, CREATE_INSTANT_INVITE, CHANGE_NICKNAME, MANAGE_NICKNAMES, MANAGE_EMOJIS, MANAGE_WEBHOOKS, MANAGE_GUILD_EXPRESSIONS, USE_APPLICATION_COMMANDS, MANAGE_EVENTS, MODERATE_MEMBERS
4. Member Management
# Member info
./discord-admin.sh member-info \x3CguildId> \x3CuserId>
# Nickname management
./discord-admin.sh member-nick \x3CguildId> \x3CuserId> \x3Cnickname>
./discord-admin.sh member-nick-reset \x3CguildId> \x3CuserId>
# Timeout (mute) - Discord native
./discord-admin.sh member-timeout \x3CguildId> \x3CuserId> \x3Cduration:60s|1h|1d|7d>
./discord-admin.sh member-untimeout \x3CguildId> \x3CuserId>
# Kick
./discord-admin.sh member-kick \x3CguildId> \x3CuserId> [reason]
# Ban (with options)
./discord-admin.sh member-ban \x3CguildId> \x3CuserId> [reason] [deleteMessageDays:0-7]
./discord-admin.sh member-ban-temp \x3CguildId> \x3CuserId> \x3Cduration:7d> [reason]
# Unban
./discord-admin.sh member-unban \x3CguildId> \x3CuserId> [reason]
# Bulk moderation
./discord-admin.sh ban-list \x3CguildId> # List all bans
./discord-admin.sh kick-bulk \x3CguildId> \x3CuserId1,userId2,...> [reason]
./discord-admin.sh ban-bulk \x3CguildId> \x3CuserId1,userId2,...> [reason]
# Avatar management
./discord-admin.sh member-avatar-set \x3CguildId> \x3CuserId> \x3CimageUrl>
5. AutoMod (Pro Feature)
# List AutoMod rules
./discord-admin.sh automod-list \x3CguildId>
# Create AutoMod rule
./discord-admin.sh automod-create \x3CguildId> \x3Cname> \
keyword:badword,spam,scam \
presets:SLUR,SEXUAL,PROFANITY \
actions:BLOCK_MESSAGE,ALERT, timeout:60s
# Keyword filters
./discord-admin.sh automod-keyword \x3CguildId> \x3CruleName> add:badword,offensive
./discord-admin.sh automod-keyword \x3CguildId> \x3CruleName> remove:badword
./discord-admin.sh automod-keyword \x3CguildId> \x3CruleName> clear:true
# Preset filters (Discord-provided)
./discord-admin.sh automod-preset \x3CguildId> \x3CruleName> SLUR,SEXUAL,PROFANITY,VIOLENCE
# Regex patterns
./discord-admin.sh automod-regex \x3CguildId> \x3CruleName> pattern:'(?i)(https?://\S+)'
# Block lists
./discord-admin.sh automod-blocklist \x3CguildId> \x3CruleName> add:custom_blocklist_name
# Actions configuration
./discord-admin.sh automod-actions \x3CguildId> \x3CruleName> \
ALERT \
BLOCK_MESSAGE \
timeout:60s \
timeoutDuration:300 \
channelId:123456789
# Edit/delete rules
./discord-admin.sh automod-edit \x3CguildId> \x3CruleId> enabled:false
./discord-admin.sh automod-delete \x3CguildId> \x3CruleId>
6. Message Management
# Send messages
./discord-admin.sh msg-send \x3CchannelId> \x3Ccontent>
./discord-admin.sh msg-embed \x3CchannelId> '{"title":"Hello","description":"World","color":65280}'
# Send with attachments
./discord-admin.sh msg-send-file \x3CchannelId> \x3CfilePath> [message]
# Edit messages
./discord-admin.sh msg-edit \x3CchannelId> \x3CmessageId> \x3CnewContent>
# Delete messages
./discord-admin.sh msg-delete \x3CchannelId> \x3CmessageId>
./discord-admin.sh msg-delete-bulk \x3CchannelId> \x3CmessageId1,messageId2,...>
./discord-admin.sh msg-delete-range \x3CchannelId> \x3CbeforeMessageId> [limit:100]
# Bulk delete (14-day limit)
./discord-admin.sh msg-prune \x3CchannelId> [days:7]
# Search messages
./discord-admin.sh msg-search \x3CguildId> \x3Cquery> [channelId]
./discord-admin.sh msg-search-user \x3CguildId> \x3CuserId> [limit:100]
# Pin/Unpin
./discord-admin.sh msg-pin \x3CchannelId> \x3CmessageId>
./discord-admin.sh msg-unpin \x3CchannelId> \x3CmessageId>
./discord-admin.sh msg-pins \x3CchannelId>
# Get message history
./discord-admin.sh msg-history \x3CchannelId> [limit:100]
7. Webhooks (Advanced)
# List webhooks
./discord-admin.sh webhook-list \x3CguildId> [channelId]
./discord-admin.sh webhook-list \x3CguildId> \x3CchannelId>
# Create webhook
./discord-admin.sh webhook-create \x3CchannelId> \x3Cname> [avatarUrl]
# Get webhook info
./discord-admin.sh webhook-info \x3CwebhookId>
# Edit webhook
./discord-admin.sh webhook-edit \x3CwebhookId> name:\x3Cname> channel:\x3CchannelId>
./discord-admin.sh webhook-edit \x3CwebhookId> avatar:\x3CimageUrl>
# Execute webhook (send as webhook)
./discord-admin.sh webhook-execute \x3CwebhookId> \x3Ccontent>
./discord-admin.sh webhook-execute \x3CwebhookId> \x3Ccontent> username:\x3CcustomName> avatar:\x3CcustomAvatar>
./discord-admin.sh webhook-execute \x3CwebhookId> \x3Ccontent> tts:true
./discord-admin.sh webhook-execute \x3CwebhookId> embed:'{"title":"Embed","description":"内容"}'
# Delete webhook
./discord-admin.sh webhook-delete \x3CwebhookId>
8. Emojis & Stickers
# List emojis
./discord-admin.sh emoji-list \x3CguildId>
# Create emoji (from URL or base64)
./discord-admin.sh emoji-create \x3CguildId> \x3Cname> \x3CimageUrl>
./discord-admin.sh emoji-create \x3CguildId> \x3Cname> \x3Cbase64Data>
# Delete emoji
./discord-admin.sh emoji-delete \x3CguildId> \x3CemojiId>
# Modify emoji
./discord-admin.sh emoji-edit \x3CguildId> \x3CemojiId> \x3CnewName>
# List stickers
./discord-admin.sh sticker-list \x3CguildId>
# Create sticker
./discord-admin.sh sticker-create \x3CguildId> \x3Cname> \x3Ctag> \x3CimageUrl>
# Edit sticker
./discord-admin.sh sticker-edit \x3CguildId> \x3CstickerId> name:\x3Cname> tags:\x3Ctags>
# Delete sticker
./discord-admin.sh sticker-delete \x3CguildId> \x3CstickerId>
9. Soundboard (Beta)
# List soundboard sounds
./discord-admin.sh soundboard-list \x3CguildId>
# Play sound (triggers in voice channel)
./discord-admin.sh soundboard-play \x3CguildId> \x3CsoundId> [volume:100]
# Default sounds
./discord-admin.sh soundboard-defaults \x3CguildId>
10. Scheduled Events
# List events
./discord-admin.sh event-list \x3CguildId>
# Create event
./discord-admin.sh event-create \x3CguildId> \x3Cname> \x3Cdescription> \x3CstartTime> endTime:\x3CendTime> channel:\x3CchannelId>
./discord-admin.sh event-create \x3CguildId> "Gaming Night" "Join us!" 2024-12-31T20:00:00Z channel:123456789 entityType:VOICE
# Event types: VOICE, STAGE_INSTANCE, EXTERNAL
# Edit event
./discord-admin.sh event-edit \x3CguildId> \x3CeventId> name:\x3Cname> description:\x3Cdesc>
./discord-admin.sh event-edit \x3CguildId> \x3CeventId> status:SCHEDULED|ACTIVE|COMPLETED|CANCELED
# Delete event
./discord-admin.sh event-delete \x3CguildId> \x3CeventId>
11. Invites
# List invites
./discord-admin.sh invite-list \x3CguildId>
# Create invite
./discord-admin.sh invite-create \x3CchannelId> [maxUses:0] [maxAge:86400] [temporary:true]
./discord-admin.sh invite-create \x3CchannelId> maxUses:100 maxAge:3600 unique:true
# Get invite info
./discord-admin.sh invite-info \x3CinviteCode>
# Delete invite
./discord-admin.sh invite-delete \x3CguildId> \x3CinviteCode>
# Vanity URL (server setting)
./discord-admin.sh vanity-get \x3CguildId>
./discord-admin.sh vanity-set \x3CguildId> \x3Ccode>
12. Audit Logs
# Get audit logs
./discord-admin.sh audit-logs \x3CguildId> [limit:100]
./discord-admin.sh audit-logs \x3CguildId> user:\x3CuserId>
./discord-admin.sh audit-logs \x3CguildId> action:CHANNEL_CREATE,BAN,KICK
# Audit action types:
# GUILD_UPDATE, CHANNEL_CREATE, CHANNEL_UPDATE, CHANNEL_DELETE, CHANNEL_OVERWRITE_CREATE, CHANNEL_OVERWRITE_UPDATE, CHANNEL_OVERWRITE_DELETE, MEMBER_KICK, MEMBER_PRUNE, BAN_ADD, BAN_REMOVE, MEMBER_UPDATE, MEMBER_ROLE_UPDATE, ROLE_CREATE, ROLE_UPDATE, ROLE_DELETE, INVITE_CREATE, INVITE_UPDATE, INVITE_DELETE, WEBHOOK_CREATE, WEBHOOK_UPDATE, WEBHOOK_DELETE, EMOJI_CREATE, EMOJI_UPDATE, EMOJI_DELETE, MESSAGE_DELETE, MESSAGE_BULK_DELETE, MESSAGE_PIN, MESSAGE_UNPIN, STAGE_INSTANCE_CREATE, STAGE_INSTANCE_UPDATE, STAGE_INSTANCE_DELETE, THREAD_CREATE, THREAD_UPDATE, THREAD_DELETE
13. Thread Management
# List threads
./discord-admin.sh thread-list \x3CguildId>
./discord-admin.sh thread-list \x3CchannelId>
# Create thread
./discord-admin.sh thread-create \x3CchannelId> \x3Cname> \x3CmessageId> [autoArchive:1440]
./discord-admin.sh thread-create \x3CchannelId> \x3Cname> autoArchive:4320
# Edit thread
./discord-admin.sh thread-edit \x3CthreadId> name:\x3Cname> archived:true
./discord-admin.sh thread-edit \x3CthreadId> locked:true autoArchive:10080
# Delete thread
./discord-admin.sh thread-delete \x3CthreadId>
# Join/Leave thread
./discord-admin.sh thread-join \x3CthreadId>
./discord-admin.sh thread-leave \x3CthreadId>
14. Stage Channels
# Create stage instance
./discord-admin.sh stage-create \x3CchannelId> [topic:"Open Mic"]
# Edit stage
./discord-admin.sh stage-edit \x3CchannelId> topic:\x3Ctopic> privacyLevel:GUILD_ONLY
./discord-admin.sh stage-edit \x3CchannelId> scheduledStart:\x3CISO8601>
# Close stage
./discord-admin.sh stage-close \x3CchannelId>
15. Integration Management
# List integrations (bots, apps)
./discord-admin.sh integration-list \x3CguildId>
# Integration operations
./discord-admin.sh integration-sync \x3CguildId> \x3CintegrationId>
./discord-admin.sh integration-delete \x3CguildId> \x3CintegrationId>
16. Guild Settings
# Edit server settings
./discord-admin.sh guild-edit \x3CguildId> name:\x3CnewName>
./discord-admin.sh guild-edit \x3CguildId> icon:\x3CimageUrl>
./discord-admin.sh guild-edit \x3CguildId> splash:\x3CimageUrl>
./discord-admin.sh guild-edit \x3CguildId> region:\x3CvoiceRegion>
./discord-admin.sh guild-edit \x3CguildId> afkChannel:\x3CchannelId> afkTimeout:900
./discord-admin.sh guild-edit \x3CguildId> systemChannel:\x3CchannelId> notifications:ALL_MESSAGES
./discord-admin.sh guild-edit \x3CguildId> explicitContentFilter:ALL_MEMBERS
./discord-admin.sh guild-edit \x3CguildId> mfaLevel:ELEVATED
./discord-admin.sh guild-edit \x3CguildId> verificationLevel:HIGH
./discord-admin.sh guild-edit \x3CguildId> defaultNotifications:ALL_MESSAGES
# Community features
./discord-admin.sh guild-enable-community \x3CguildId>
./discord-admin.sh guild-disable-community \x3CguildId>
# Server merge/transfer
./discord-admin.sh guild-transfer \x3CguildId> \x3CnewOwnerId>
17. Widget Management
# Widget settings
./discord-admin.sh widget-get \x3CguildId>
./discord-admin.sh widget-edit \x3CguildId> enabled:true channel:\x3CchannelId>
18. Moderation Logging
# Setup moderation log
./discord-admin.sh modlog-set \x3CguildId> \x3CchannelId>
./discord-admin.sh modlog-get \x3CguildId>
./discord-admin.sh modlog-disable \x3CguildId>
# Configuration
./discord-admin.sh modlog-config \x3CguildId> \
kicks:true \
bans:true \
messages:true \
nickname:true \
roles:true \
invites:true
19. Bulk/Mass Operations
# Mass ban
./discord-admin.sh mass-ban \x3CguildId> \x3CuserIdsFileOrComma> [reason]
# Mass kick
./discord-admin.sh mass-kick \x3CguildId> \x3CuserIdsFileOrComma> [reason]
# Mass role assignment
./discord-admin.sh mass-role \x3CguildId> \x3CroleId> \x3CuserIdsFileOrComma>
# Channel sync (copy permissions)
./discord-admin.sh channel-sync-perms \x3CsourceChannelId> \x3CtargetChannelId>
# Role sync (copy all settings)
./discord-admin.sh role-clone \x3CguildId> \x3CroleId> \x3CnewName>
20. Template Operations
# Templates
./discord-admin.sh template-list \x3CguildId>
./discord-admin.sh template-create \x3CguildId> \x3Cname> [description]
./discord-admin.sh template-sync \x3CguildId> \x3CtemplateCode>
./discord-admin.sh template-delete \x3CguildId> \x3CtemplateId>
# Create server from template
./discord-admin.sh template-use \x3CtemplateCode> \x3CnewServerName>
⚙️ Configuration
Environment Variables
export DISCORD_BOT_TOKEN="your-bot-token"
export DISCORD_GUILD_ID="default-guild-id"
export DISCORD_DEFAULT_TIMEOUT=60 # API timeout in seconds
export DISCORD_MAX_RETRIES=3 # Retry on rate limit
export DISCORD_OUTPUT_FORMAT="json" # json, pretty, minimal
Required Permissions
Option A: Administrator (easiest)
- Requires:
ADMINISTRATORpermission
Option B: Granular permissions
MANAGE_CHANNELS
MANAGE_ROLES
KICK_MEMBERS
BAN_MEMBERS
MANAGE_MESSAGES
MANAGE_GUILD
VIEW_AUDIT_LOG
MANAGE_EMOJIS
MANAGE_WEBHOOKS
MANAGE_GUILD_EXPRESSIONS
MANAGE_EVENTS
MODERATE_MEMBERS
Rate Limiting
The script handles Discord's rate limits automatically:
- 1 req/1s per channel for message sends
- 50 req/10s for other operations
- Exponential backoff on 429 errors
- Global rate limit detection
📊 Examples
Complete Server Setup
#!/bin/bash
# Setup a new community server from scratch
GUILD="123456789"
TOKEN="your-token"
# 1. Create roles
./discord-admin.sh role-create $GUILD "Admin" color:#FF0000 permissions:ADMINISTRATOR
./discord-admin.sh role-create $GUILD "Moderator" color:#FFA500 permissions:KICK_MEMBERS,BAN_MEMBERS,MANAGE_MESSAGES
./discord-admin.sh role-create $GUILD "Member" color:#00FF00 permissions:CREATE_INSTANT_INVITE
# 2. Create channels
./discord-admin.sh channel-create $GUILD "general" text
./discord-admin.sh channel-create $GUILD "announcements" announcements
./discord-admin.sh channel-create $GUILD "Voice Channels" category
# 3. Setup AutoMod
./discord-admin.sh automod-create $GUILD "Anti-Spam" keyword:scam,free,nitro actions:BLOCK_MESSAGE,ALERT
# 4. Create invite
INVITE=$(./discord-admin.sh invite-create 123456789 maxUses:100 unique:true | jq -r '.code')
echo "Server invite: discord.gg/$INVITE"
# 5. Setup mod log
./discord-admin.sh modlog-set $GUILD 987654321
Daily Moderation Routine
#!/bin/bash
# Daily server maintenance
GUILD="123456789"
TOKEN="your-token"
# Check audit logs for suspicious activity
./discord-admin.sh audit-logs $GUILD action:BAN_ADD --format pretty
# Check mod log
./discord-admin.sh audit-logs $GUILD user:BOT_USER_ID --format pretty
# List recent bans
./discord-admin.sh audit-logs $GUILD action:BAN_ADD limit:50 --format pretty
# Prune old inactive members
./discord-admin.sh member-prune $GUILD 30
# Check for spammers
./discord-admin.sh automod-list $GUILD
🔧 Troubleshooting
Common Errors
| Error | Solution |
|---|---|
401: Unauthorized |
Check your bot token |
403: Forbidden |
Bot lacks permissions |
404: Not Found |
Invalid channel/guild/role ID |
429: Too Many Requests |
Wait, script handles this |
50013: Missing Permissions |
Bot role is below target role |
50001: Missing Access |
Bot can't see the channel |
Debug Mode
./discord-admin.sh --debug \x3Ccommand>
📝 Notes
- 14-day limit: Bulk delete only works on messages from the last 14 days
- Role hierarchy: Bot role must be higher than target roles
- Ownership: Some operations require server owner
- Vanity URLs: Require
DISCOVERABLEfeature and boosts - Templates: Only available to users with
MANAGE_GUILD - Audit logs: Only viewable by bots with
VIEW_AUDIT_LOG, retention is 90 days
🤖 Supported API Endpoints
- Guilds & Guild Members
- Channels & Threads
- Roles & Permissions
- Messages & Reactions
- AutoModeration Rules
- Webhooks
- Invites & Vanity URLs
- Guild Templates
- Emojis & Stickers
- Guild Scheduled Events
- Stage Instances
- Soundboard Sounds
- Audit Logs
- Integrations
- Guild Widgets
- Application Commands (partial)
Usage Guidance
This package implements a full Discord admin CLI and therefore needs a Discord bot token and command-line tools (curl, jq). Before installing or running it: 1) Do not paste your production bot token into an unfamiliar script — treat DISCORD_BOT_TOKEN as highly sensitive. 2) Because the registry metadata omits required env vars and binaries, manually inspect the included scripts (discord-admin.sh and discord-ctrl.sh) — they are provided in plain Bash and call only discord.com APIs, but you should still verify for unexpected network calls or backdoors. 3) Prefer using a test bot account with limited permissions (least privilege) when trying this out. 4) Run the scripts in an isolated environment (container or throwaway VM) if you can't fully audit them. 5) Ask the publisher for provenance or a signed release; absence of a homepage/source makes it harder to trust. If you want, I can summarize specific lines of the scripts or search them for suspicious network destinations or code patterns to help with the review.
Capability Analysis
Type: OpenClaw Skill
Name: discord-admin
Version: 1.0.0
This skill bundle provides extensive Discord server administration capabilities, including highly sensitive actions such as transferring guild ownership, mass banning/kicking members, creating roles with administrator permissions, and full control over channels, messages, and webhooks. While these capabilities align with the stated purpose of 'Complete A-Z Discord server administration', they represent significant high-risk functionalities that could be misused. The `discord-admin.sh` script uses `curl` to interact exclusively with the Discord API and handles the bot token as an environment variable, which is standard. There is no evidence of data exfiltration to external endpoints, malicious execution (e.g., `curl|bash`), persistence mechanisms, or obfuscation. The `SKILL.md` documentation accurately describes these powerful features without attempting prompt injection against the agent to hide actions or access unrelated sensitive data. The classification is 'suspicious' due to the inherent high-risk nature of the administrative capabilities, even though they are explicitly documented and appear to be intentional features rather than hidden malicious behavior.
Capability Assessment
Purpose & Capability
The skill claims full Discord server administration and the included scripts implement that via the Discord API — capability matches purpose. However the package metadata declares no required environment variables or binaries, while the runtime clearly expects DISCORD_BOT_TOKEN (and optionally DISCORD_GUILD_ID) and the presence of curl and jq. That mismatch is an incoherence in the package description.
Instruction Scope
SKILL.md and the scripts instruct the agent to call Discord's API endpoints using a bot token and to run local CLI scripts. The instructions do not attempt to read unrelated system files or call external endpoints other than discord.com. They do, however, instruct the user/agent to export a sensitive DISCORD_BOT_TOKEN which is necessary for the stated functionality.
Install Mechanism
There is no install spec (instruction-only), which is lower-risk in principle. But the skill bundle contains two executable shell scripts. Because files are included, the agent/package will write these scripts to disk and users will run them; the package does not provide an install step or provenance for those scripts. That increases the need for manual review of the code before execution.
Credentials
The scripts require a DISCORD_BOT_TOKEN (and optionally DISCORD_GUILD_ID) — appropriate for a Discord admin tool. However the registry metadata lists no required env vars or primary credential. The omission is problematic because DISCORD_BOT_TOKEN is sensitive and should have been declared explicitly. No unrelated secrets are requested and network calls are only to Discord's API.
Persistence & Privilege
The skill does not request always:true and does not attempt to modify other skills or system-wide configs. Autonomous invocation is allowed (platform default) but is not combined here with other high-risk factors.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install discord-admin - After installation, invoke the skill by name or use
/discord-admin - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of complete Discord server administration via CLI.
- Provides full control of Discord servers: manage channels, roles, members, AutoMod, webhooks, templates, audit logs, scheduled events, and threads.
- Supports advanced moderation tools: mass actions, timeouts, audit log access, and detailed permission management.
- Includes AutoMod with keyword, preset, regex, block list, and fine-grained action configuration.
- Enables bulk operations for channels, roles, and member moderation.
- All commands accessible via a structured bash interface for automation and scripting.
Metadata
Frequently Asked Questions
What is discord admin?
Complete A-Z Discord server administration. Channel/role/member management, AutoMod, webhooks, templates, audit logs, scheduled events, threads, and full server control via CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 1720 downloads so far.
How do I install discord admin?
Run "/install discord-admin" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is discord admin free?
Yes, discord admin is completely free (open-source). You can download, install and use it at no cost.
Which platforms does discord admin support?
discord admin is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created discord admin?
It is built and maintained by AYMANE SALIH AIT BRAHIM (@thebigbrainchad); the current version is v1.0.0.
More Skills