🤖 Discord Bot
Discord Bot API integration — manage servers, channels, messages, roles, members, and webhooks via the Discord REST API.
Features
- Send messages — text, embeds, files to any channel
- Channel management — create, update, delete channels
- Server info — guild details, settings, and statistics
- Member management — list, kick, ban, role assignment
- Role management — create, update, assign roles
- Message operations — send, edit, delete, react, pin
- Webhook management — create and send via webhooks
- Thread management — create and manage threads
- Emoji management — list and manage custom emojis
- Audit log — view server audit events
Requirements
| Variable | Required | Description |
|---|---|---|
DISCORD_BOT_TOKEN | ✅ | API key/token for Discord Bot |
Quick Start
# List bot's servers
python3 {baseDir}/scripts/discord-bot.py guilds
# Get server details
python3 {baseDir}/scripts/discord-bot.py guild-get 123456789
# List server channels
python3 {baseDir}/scripts/discord-bot.py channels --guild 123456789
# Create a channel
python3 {baseDir}/scripts/discord-bot.py channel-create --guild 123456789 "general-chat" --type text
Commands
guilds
List bot's servers.
python3 {baseDir}/scripts/discord-bot.py guilds
guild-get
Get server details.
python3 {baseDir}/scripts/discord-bot.py guild-get 123456789
channels
List server channels.
python3 {baseDir}/scripts/discord-bot.py channels --guild 123456789
channel-create
Create a channel.
python3 {baseDir}/scripts/discord-bot.py channel-create --guild 123456789 "general-chat" --type text
channel-update
Update channel.
python3 {baseDir}/scripts/discord-bot.py channel-update 987654321 '{"name":"announcements","topic":"Important updates"}'
send
Send a message.
python3 {baseDir}/scripts/discord-bot.py send --channel 987654321 "Hello from the bot!"
send-embed
Send embed message.
python3 {baseDir}/scripts/discord-bot.py send-embed --channel 987654321 '{"title":"Update","description":"New feature released","color":5814783}'
messages
List channel messages.
python3 {baseDir}/scripts/discord-bot.py messages --channel 987654321 --limit 20
message-edit
Edit a message.
python3 {baseDir}/scripts/discord-bot.py message-edit --channel 987654321 --message 111222333 "Updated text"
message-delete
Delete a message.
python3 {baseDir}/scripts/discord-bot.py message-delete --channel 987654321 --message 111222333
react
Add reaction to message.
python3 {baseDir}/scripts/discord-bot.py react --channel 987654321 --message 111222333 --emoji 👍
members
List server members.
python3 {baseDir}/scripts/discord-bot.py members --guild 123456789 --limit 50
roles
List server roles.
python3 {baseDir}/scripts/discord-bot.py roles --guild 123456789
role-assign
Assign role to member.
python3 {baseDir}/scripts/discord-bot.py role-assign --guild 123456789 --user 444555666 --role 777888999
webhooks
List channel webhooks.
python3 {baseDir}/scripts/discord-bot.py webhooks --channel 987654321
Output Format
All commands output JSON by default. Add --human for readable formatted output.
# JSON (default, for programmatic use)
python3 {baseDir}/scripts/discord-bot.py guilds --limit 5
# Human-readable
python3 {baseDir}/scripts/discord-bot.py guilds --limit 5 --human
Script Reference
| Script | Description |
|---|---|
{baseDir}/scripts/discord-bot.py | Main CLI — all Discord Bot operations |
Data Policy
This skill never stores data locally. All requests go directly to the Discord Bot API and results are returned to stdout. Your data stays on Discord Bot servers.
Credits
Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.
📅 Need help setting up OpenClaw for your business? Book a free consultation