A zero-dependency Python integration for AI agents to manage Discord servers, roles, and messaging via the Discord REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install discord-bot
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install discord-bot using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Discord Bot?
The Discord Bot skill is a lightweight, high-performance bridge designed for AI agents to interact directly with the Discord ecosystem. Built using only the Python standard library, this integration ensures maximum compatibility and security without the overhead of external dependencies. It empowers developers to build autonomous community managers that can handle everything from basic messaging to complex server administration.
By utilizing Openclaw Skills, this tool provides a structured way for agents to perform programmatic actions such as channel creation, member moderation, and webhook management. Whether you are building a support agent or an automated notification system, this skill provides the reliable connectivity required for modern Discord-based workflows.
Discord Bot Use Cases
- Automating community moderation by kicking or banning users based on agent-detected policy violations.
- Dispatching rich embed notifications for system alerts or marketing updates across multiple channels.
- Managing server onboarding by automatically assigning roles to new members.
- Creating and organizing channel structures for project-based Discord servers.
- Retrieving server audit logs for automated security reporting.
How Discord Bot Works
- The AI agent authenticates with the Discord API using a secure bot token stored in environment variables.
- Commands are issued via a CLI interface, specifying the desired action such as sending a message or listing members.
- The skill performs a stateless HTTP request to the Discord REST API using Python's built-in networking capabilities.
- Discord processes the request and returns data related to the server, channel, or operation.
- The skill outputs the result in JSON format by default, allowing Openclaw Skills to parse and act upon the information instantly.
Discord Bot Setup
To get started, ensure you have a bot token from the Discord Developer Portal.
- Set your environment variable:
export DISCORD_BOT_TOKEN='your_discord_bot_token_here'
- Verify the installation by listing the servers your bot has joined:
python3 scripts/discord-bot.py guilds
- To see results in a format easier for developers to read, use the human flag:
python3 scripts/discord-bot.py guilds --human
Discord Bot Data Schema & Taxonomy
This skill is designed with a stateless architecture, ensuring no sensitive data is cached locally. All data is processed in-memory and passed back to the agent.
| Component | Description |
|---|---|
| Authentication | Uses the DISCORD_BOT_TOKEN environment variable for all API calls. |
| Output Format | Standardized JSON for agent interoperability; optional human-readable text for CLI use. |
| Communication | Direct HTTPS requests to the official Discord REST API v10. |
| Resource IDs | Uses standard Snowflake IDs for guilds, channels, and users. |
Discord Bot Advanced Features
- Support for complex rich embeds with custom hex colors and metadata.
- Detailed thread management for organizing sub-conversations within channels.
- Webhook management for creating and triggering external service integrations.
- Role-based access control management to programmatically adjust user permissions.
- Human-readable output mode for debugging and manual administrative tasks.
SKILL.md
Loading
Related Openclaw Skills
Deep Search
A multi-tier AI search routing skill that automates fact-checking and deep research using Perplexity models.
Deep Search
A sophisticated multi-tier Perplexity search skill providing AI-synthesized answers with citations and observability tracing.
Datadog
A streamlined CLI tool for Openclaw Skills to manage Datadog infrastructure, metrics, and incidents via the REST API.
Cost Tracker
A dedicated AI spending monitor for tracking, reporting, and optimizing OpenRouter costs through a powerful command-line interface.
DocuSign e-Signatures
A lightweight Python-based skill for managing DocuSign envelopes, templates, and recipients through a streamlined CLI.
EasyPost Shipping & Logistics
A comprehensive logistics tool for generating shipping labels, comparing carrier rates, verifying addresses, and tracking packages.
Featured*
