Zum Inhalt springen
Anleitung · Discord-Bot

Discord-Bot mit Python und discord.py hosten

Python-Bots mit discord.py, py-cord, nextcord oder anderen Bibliotheken laufen bei uns direkt. Die Pakete stehen in der requirements.txt, der Token kommt aus der Umgebungsvariable.

3 Min. LesezeitAktualisiert am 18.11.2026
Inhalt
  1. Python-Version wählen
  2. Was beim Start passiert
  3. requirements.txt anlegen
  4. discord.py, py-cord oder nextcord
  5. Startdatei und Konsole
  6. Der Token in Python
  7. Der Beispiel-Bot mit discord.py
  8. Typische Meldungen bei Python
  9. Fertige Vorlage auf GitHub

Python-Version wählen

Unter Bot › Bot-Einstellungen wählst du Python 3.11, 3.12, 3.13 oder 3.14. Nimm die Version, mit der dein Bot auf deinem PC läuft. Die Pakete installiert pip im Ordner .local deines Servers. Nach dem Wechsel startest du den Bot neu.

Kundencenter, Bot › Bot-Einstellungen: Python-Version, Token und Startdatei
Kundencenter, Bot › Bot-Einstellungen: Python-Version, Token und Startdatei

Was beim Start passiert

Bei jedem Start arbeitet der Server diese Schritte der Reihe nach ab:

  1. Ist ein Git-Repository verbunden und Automatisch aktualisieren auf 1 gesetzt, holt er zuerst den neuesten Stand mit git pull.
  2. Pakete aus dem Feld Zusätzliche Pakete (zum Beispiel aiohttp python-dotenv) installiert pip.
  3. Gibt es die Requirements-Datei, installiert pip alle Pakete daraus.
  4. Fehlt die Startdatei, bleibt der Server an und meldet „Startdatei … nicht gefunden“. Sonst startet python -u die Datei.

requirements.txt anlegen

  • In die requirements.txt schreibst du pro Zeile ein Paket, der Beispiel-Bot enthält die Zeile discord.py>=2.4.
  • Den Dateinamen änderst du im Feld Requirements-Datei der Bot-Einstellungen, zum Beispiel für eine Datei in einem Unterordner.
  • Lade keinen Ordner .venv oder venv hoch. Die Pakete entstehen auf dem Server aus deiner requirements.txt.

discord.py, py-cord oder nextcord

Alle drei Bibliotheken laufen auf dem Server, solange ihre Pakete in der requirements.txt stehen. Sie teilen sich den Paketnamen discord und stören sich gegenseitig, deshalb gehört immer nur eine von ihnen in die Datei.

  • Der Beispiel-Bot nutzt discord.py mit app_commands für Slash-Befehle.
  • Nach einem Wechsel der Bibliothek passt du auch die Importe in deinem Code an.

Startdatei und Konsole

Die Startdatei (Standard: main.py) trägst du in den Bot-Einstellungen ein, zum Beispiel bot.py oder src/main.py. Der Server startet Python mit der Option -u, also ungepuffert: Jede Ausgabe von print erscheint sofort in der Konsole.

Der Token in Python

Lies den Token mit os.environ["DISCORD_TOKEN"] und trage ihn im Feld Discord-Bot-Token ein, siehe Bot-Token eintragen. Die Umgebungsvariable ist auch ohne python-dotenv und ohne .env-Datei gesetzt.

Der Beispiel-Bot mit discord.py

Nach der Bestellung liegt ein Beispiel-Bot bereit (main.py und requirements.txt). Er nutzt discord.Intents.default(), registriert über tree.sync() den Befehl /ping und antwortet mit der Latenz.

In der Konsole siehst du „Bot ist online als …“. Fehlt der Token, meldet der Beispiel-Bot „Kein Bot-Token gesetzt“ und bleibt aktiv, bis du ihn einträgst. Fängt discord.py einen LoginFailure ab, steht in der Konsole „Anmeldung bei Discord fehlgeschlagen“ mit der Meldung der Bibliothek.

Typische Meldungen bei Python

  • ModuleNotFoundError: No module named 'xyz': Das Paket fehlt in der requirements.txt oder steht dort unter einem anderen Namen als im Import.
  • Improper token has been passed: Der Token ist falsch oder wurde im Developer Portal zurückgesetzt.
  • PrivilegedIntentsRequired: Dein Code fordert einen Intent an, der im Developer Portal nicht eingeschaltet ist.
  • Startdatei … nicht gefunden: Dateiname oder Ordner in den Bot-Einstellungen passen nicht zu dem, was unter Dateien liegt.

Fertige Vorlage auf GitHub

Als Ausgangspunkt gibt es eine freie Vorlage für Python (discord.py): discord-bot-starter-python. Sie enthält Slash-Befehle, Beispielbefehle, ein Dockerfile und eine ausführliche Anleitung auf Deutsch (MIT-Lizenz). Du kannst sie auch ohne VentroHosting nutzen.

Häufige Fragen

Mein Bot meldet „ModuleNotFoundError“. Was tun?

Das Paket fehlt in der requirements.txt. Trage es dort ein oder in den Bot-Einstellungen bei „Zusätzliche Pakete“ und starte neu.

Warum erscheinen meine print-Ausgaben sofort in der Konsole?

Der Server startet Python mit der Option -u, also ohne Pufferung. Du brauchst kein flush=True.

Darf die requirements.txt anders heißen?

Ja. Den Namen trägst du in den Bot-Einstellungen im Feld „Requirements-Datei“ ein, auch mit Ordner.

Nächster Schritt

Unsere Empfehlung: Bot Plus

1 GB RAM für 2,99 € pro 30 Tage, ohne Abo. Nach der Bezahlung wird der Server automatisch eingerichtet.