Discord

Deploy agents to Discord for community support and moderation.

The Discord integration connects any Agno agent to Discord via the Gateway API, so you don’t need to set up webhooks.

Quick Start

discord_agent.py

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.integrations.discord import DiscordClient

agent = Agent(name="Assistant", model=OpenAIResponses(id="gpt-5.4"))

discord_client = DiscordClient(agent)

if __name__ == "__main__":
    discord_client.serve()

uv pip install agno discord.py openai
python discord_agent.py

How It Works

Concept	Behavior
Gateway	Direct connection to Discord, no webhooks or tunnels needed
Threads	Auto-creates threads for conversations with isolated context
Intents	Requires Message Content Intent enabled in Developer Portal
Permissions	Send Messages, Read History, Create Threads, Attach Files

Setup

You need a Discord Application with a bot user. Create one in the Discord Developer Portal.

Then set your bot token as an environment variable:

export DISCORD_BOT_TOKEN="..."

Next Steps

Full Guide

Bot setup, threads, intents, and permissions.

Examples

Basic agent, media handling, and user memory.

DiscordTools

Give agents channel, message, and reaction capabilities.

Discord Developer Portal

Create and manage your Discord application.