| name | discord-bot |
| description | Discord Bot API integration โ manage servers, channels, messages, roles, members, and webhooks via the Discord REST API. Send messages, manage server settings, moderate users, create channels, and handle role assignments. Built for AI agents โ Python stdlib only, zero dependencies. Use for Discord server management, bot automation, community management, message sending, moderation, and webhook integrations. |
| homepage | https://www.agxntsix.ai |
๐ค 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
python3 {baseDir}/scripts/discord-bot.py guilds
python3 {baseDir}/scripts/discord-bot.py guild-get 123456789
python3 {baseDir}/scripts/discord-bot.py channels --guild 123456789
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.
python3 {baseDir}/scripts/discord-bot.py guilds --limit 5
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
