Как сделать Discord-бота на Python: добавляем первую команду и ответ

Чтобы сделать Discord-бота на Python, создайте приложение в Developer Portal, сохраните токен в .env, подключите discord.py и зарегистрируйте slash-команду /hello. Команда будет доступна только на тестовом сервере и ответит пользователю по имени. Для неё не нужен привилегированный доступ к содержимому всех сообщений, поэтому стартовая конфигурация остаётся небольшой и понятной.

У Discord есть два разных объекта, которые новичок часто смешивает. Application описывает интеграцию и команды, а bot user представляет её в сервере. Токен позволяет программе действовать от имени этого бота, поэтому его нельзя вставлять в статью, отправлять в чат или коммитить в Git. В этом проекте секрет останется в локальном файле .env, а код получит его через переменную окружения.

Что подготовить в Discord и в папке проекта

Откройте Discord Developer Portal, создайте новое приложение и добавьте bot user в разделе Bot. Скопируйте токен один раз в .env. Затем включите Developer Mode в настройках клиента Discord и скопируйте ID своего тестового сервера. ID не является паролем, но токен является. Для быстрой разработки используем guild-команду: Discord рекомендует команды сервера для тестирования, а глобальные оставляет для готовой публичной версии.

Приложение хранит настройки, bot user виден на сервере, а Python-процесс подключается по секретному токену.

Пишем бота со slash-командой /hello

Создайте виртуальное окружение командами python -m venv .venv и python -m pip install -U discord.py python-dotenv. В .env положите строки DISCORD_TOKEN=... и DISCORD_GUILD_ID=.... Сам файл назовите bot.py, а не discord.py, иначе он перекроет импорт установленной библиотеки.

import os

import discord
from discord import app_commands
from dotenv import load_dotenv

load_dotenv()

TOKEN = os.getenv("DISCORD_TOKEN")
GUILD_ID = os.getenv("DISCORD_GUILD_ID")

if not TOKEN or not GUILD_ID:
    raise RuntimeError("Заполните DISCORD_TOKEN и DISCORD_GUILD_ID в .env")

TEST_GUILD = discord.Object(id=int(GUILD_ID))


class CodikClient(discord.Client):
    async def setup_hook(self) -> None:
        commands = await tree.sync(guild=TEST_GUILD)
        print(f"Синхронизировано команд: {len(commands)}")


intents = discord.Intents.default()
client = CodikClient(intents=intents)
tree = app_commands.CommandTree(client)


@tree.command(
    name="hello",
    description="Поздороваться с ботом",
    guild=TEST_GUILD,
)
async def hello(interaction: discord.Interaction) -> None:
    await interaction.response.send_message(
        f"Привет, {interaction.user.display_name}! Бот работает."
    )


@client.event
async def on_ready() -> None:
    print(f"Вошли как {client.user}")


client.run(TOKEN)

Пользователь вызывает команду, Discord передаёт interaction, а обработчик отправляет один ответ.

Как добавить приложение на тестовый сервер

В разделе Installation или OAuth2 URL Generator выберите установку на сервер и scope bot. Scope applications.commands включается вместе с bot scope, но интерфейс портала может показывать его отдельно. Для нашего ответа достаточно разрешения отправлять сообщения. Не выдавайте Administrator ради удобства: минимальные права проще объяснить и безопаснее отлаживать.

Практика: запускаем и проверяем первый ответ

Запускайте бота из активированного виртуального окружения. Пока процесс работает, соединение с Discord остаётся открытым. Сначала дождитесь двух сообщений в терминале: количество синхронизированных команд и имя вошедшего пользователя. Затем откройте канал тестового сервера и начните вводить /hello. Guild-команда обычно удобна тем, что изменения предназначены именно для быстрой проверки.

Симптом определяет слой проверки: Python, регистрация команды, установка или права канала.

Почему бот офлайн или команда не появляется

Разделите проблему на три уровня. Если программа не стартует, читайте traceback Python. Если клиент вошёл, но команда отсутствует, проверяйте guild id, установку и синхронизацию. Если команда видна, но ответ завершается ошибкой, смотрите функцию обработчика и права в конкретном канале. Такой порядок быстрее, чем многократный сброс токена без причины.