Wie man einen Discord-Bot (Python) auf OuiPanel hostet
Diese Anleitung zeigt, wie Sie einen Discord-Bot mit Python und discord.py erstellen und auf einem Python-Server von OuiHeberg hosten, den Sie in OuiPanel verwalten, von bot.py bis zum ersten !ping. Der Bot läuft dauerhaft auf dem Server, auch wenn Ihr Computer aus ist. Sie brauchen einen im Discord Developer Portal erstellten Bot, seinen Token, die Dateien des Bots (bot.py, requirements.txt…) und einen Python-Server (siehe die Angebote für Discord-Bots).
Den Bot bei Discord erstellen
Sie haben Ihren Bot und seinen Token schon? Dann springen Sie zum nächsten Abschnitt.
Die Anwendung erstellen
Öffnen Sie das Discord Developer Portal und melden Sie sich mit Ihrem Discord-Konto an.
Klicken Sie auf New Application.
Geben Sie Ihrer Anwendung einen Namen, zum Beispiel „Mein Python-Bot“, akzeptieren Sie die Nutzungsbedingungen und klicken Sie auf Create.

Den Token abrufen
Der Token ist der geheime Schlüssel, mit dem sich Ihr Code mit dem Bot verbindet.
Suchen Sie im Bereich Bot das Feld TOKEN und klicken Sie auf Reset Token.
Bestätigen Sie im Fenster mit Yes, do it!
Klicken Sie auf Copy, um den Token zu kopieren, und bewahren Sie ihn für die nächsten Schritte sicher auf.

Der Token ist wie ein Passwort. Geben Sie ihn nie weiter und legen Sie ihn nie in öffentlichen Code (GitHub, GitLab usw.). Wird er bekannt, erzeugen Sie ihn sofort neu.
Die Intents aktivieren
Intents geben Ihrem Bot Zugriff auf bestimmte Informationen (Nachrichten, Mitglieder usw.). Scrollen Sie im Bereich Bot zu Privileged Gateway Intents, aktivieren Sie die nötigen Intents und klicken Sie auf Save Changes.
| Intent | Beschreibung | Empfehlung |
|---|---|---|
| PRESENCE INTENT | Status der Mitglieder sehen | Optional |
| SERVER MEMBERS INTENT | Auf die Mitgliederliste zugreifen | Optional |
| MESSAGE CONTENT INTENT | Nachrichteninhalte lesen | Erforderlich |

Ohne MESSAGE CONTENT INTENT kann Ihr Bot die Inhalte der Nachrichten Ihrer Nutzer nicht lesen.
Den Bot auf Ihren Discord-Server einladen
Klicken Sie im linken Menü auf OAuth2 und dann auf URL Generator.
Haken Sie unter SCOPES bot an (und applications.commands für Slash-Befehle).
Wählen Sie unter BOT PERMISSIONS die nötigen Berechtigungen (siehe Tabelle).
Kopieren Sie unten auf der Seite die erzeugte URL und öffnen Sie sie im Browser.
Wählen Sie den Server aus, klicken Sie auf Autorisieren und lösen Sie das Captcha, falls verlangt.
| Berechtigung | Beschreibung |
|---|---|
| Administrator | Alle Berechtigungen (einfach, aber weitreichend) |
| Send Messages | Nachrichten senden |
| Read Message History | Den Verlauf lesen |
| Embed Links | Embeds senden |
| Attach Files | Dateien senden |
| Use Slash Commands | Slash-Befehle nutzen |
Wählen Sie Administrator oder nur die Berechtigungen, die Ihr Bot wirklich braucht.

Ihr Bot erscheint nun in der Mitgliederliste Ihres Discord-Servers, vorerst offline.

Die Dateien des Bots vorbereiten
Dateistruktur
Ihr Bot sollte diese Struktur haben.
MonBotPython/
├── bot.py ← Hauptdatei (oder main.py, index.py...)
├── requirements.txt ← Python-Abhängigkeiten
├── .env ← Bot-Token (auf dem Server erstellt)
└── cogs/ ← (Optional) Modulordner
Die Datei requirements.txt
Legen Sie eine Datei requirements.txt mit den Abhängigkeiten discord.py und python-dotenv an.
audioop-lts==0.2.1; python_version >= "3.13"
discord.py==2.3.2
python-dotenv==1.0.0
Zwei Pakete sind unverzichtbar. discord.py ist die Bibliothek für die Kommunikation mit Discord, python-dotenv lädt den Token aus der Datei .env. Die Zeile audioop-lts ersetzt das Modul audioop, das in Python 3.13 entfernt wurde. Die Bedingung am Zeilenende installiert es nur mit dieser Version.
Die Hauptdatei (bot.py)
Legen Sie Ihre Hauptdatei an. Sie lädt den Token mit python-dotenv.
import os
import discord
from discord.ext import commands
from dotenv import load_dotenv
# Load environment variables from .env
load_dotenv()
# Configuration of intents
intents = discord.Intents.default()
intents.message_content = True
# Creating the bot with a prefix
bot = commands.Bot(command_prefix='!', intents=intents)
# Event: Bot ready
@bot.event
async def on_ready():
print(f'Bot connected as {bot.user.name}')
print(f'Connected to {len(bot.guilds)} server(s)')
# Command: !ping
@bot.command()
async def ping(ctx):
"""Responds Pong with latency"""
latency = round(bot.latency * 1000)
await ctx.send(f'Pong! Latency: {latency}ms')
# Command: !hello
@bot.command()
async def hello(ctx):
"""Says hello"""
await ctx.send(f'Hello {ctx.author.name}!')
# Error handling
@bot.event
async def on_command_error(ctx, error):
if isinstance(error, commands.CommandNotFound):
await ctx.send('Unknown command.')
else:
print(f'Error: {error}')
# Connect with the token from .env
bot.run(os.getenv('DISCORD_TOKEN'))
load_dotenv()muss aufgerufen werden, bevor Sieos.getenv()verwenden.
Die Dateien zu OuiPanel hochladen
Der Dateimanager hat keine Upload-Schaltfläche. Dateien werden per Drag-and-drop gesendet.
Melden Sie sich unter dash.ouipanel.com bei OuiPanel an und öffnen Sie Ihren Python-Server.
Klicken Sie im Seitenmenü auf Dateimanager.
Löschen Sie gegebenenfalls die Standarddateien.
Ziehen Sie
bot.py,requirements.txtund Ihre Ordner (cogs/…) von Ihrem Computer auf die Seite.Sobald die Ebene „Dateien hier ablegen“ erscheint, lassen Sie los.
Jede so gesendete Datei ist auf 100 MB begrenzt.

Laden Sie Ihre Datei
.envnicht hoch. Sie erstellen sie im nächsten Schritt direkt auf dem Server, das ist sicherer.
Per SFTP
Für viele Dateien oder Dateien über 100 MB nutzen Sie SFTP. Verbinden Sie sich mit FileZilla, ziehen Sie den gesamten Inhalt Ihres Bot-Ordners hinüber und prüfen Sie, ob alles angekommen ist. Die Anleitung Per SFTP mit FileZilla verbinden erklärt die Verbindung.
Die Datei .env erstellen
Schreiben Sie Ihren Token nie direkt in den Code. Legen Sie auf dem Server eine Datei .env an.
Klicken Sie im Dateimanager, im Stammverzeichnis, auf Datei erstellen.
Geben Sie im Fenster „Neue Datei erstellen“ unter Dateiname
.envein, mit dem Punkt am Anfang, und klicken Sie auf Datei erstellen.Klicken Sie auf
.env, um die Datei im Editor zu öffnen, und fügen Sie den Inhalt unten ein.Ersetzen Sie
your_token_heredurch den kopierten Token und klicken Sie auf Speichern.
# Discord bot token
DISCORD_TOKEN=your_token_here
Beispiel mit einem echten Token (Format):
DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
Beispiel mit mehreren Variablen:
# Discord bot token
DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
# Command prefix
PREFIX=!
# Owner ID (optional)
OWNER_ID=123456789012345678
Keine Leerzeichen um das
=.Keine Anführungszeichen um die Werte.
Geben Sie diese Datei nie weiter.

So sieht die fertige Struktur auf dem Server aus.
Root of the server/
├── .env ← Contains DISCORD_TOKEN
├── bot.py ← Your code
├── requirements.txt ← Dependencies
└── ...
Startdatei und Python-Version festlegen
OuiPanel muss wissen, welche Python-Datei beim Start ausgeführt wird. Auf einem Python-Server ist das eine Servervariable.
Öffnen Sie Konfiguration › Servereinstellungen.
Prüfen Sie in der Karte Serverstart die Systemversion. Die Liste bietet Python 2.7 und alle Versionen von 3.7 bis 3.13, wobei 3.13 ein Release Candidate ist. Empfohlen ist 3.12.
Tragen Sie in der Karte Umgebungsvariablen den Namen Ihrer Datei unter Python-Startdatei ein (Startdatei; die Variablennamen erscheinen auf Französisch).
Klicken Sie auf das Häkchen rechts neben dem Feld (Speichern).
| Ihre Hauptdatei | Wert von Python-Startdatei |
|---|---|
bot.py | bot.py |
main.py | main.py |
index.py | index.py |
app.py | app.py |
src/bot.py | src/bot.py |
Dieselbe Karte zeigt unter Abhängigkeitsdatei die zu installierende Anforderungsdatei (standardmäßig requirements.txt). Zusätzliche Python-Pakete installiert weitere Pakete, durch Leerzeichen getrennt.

Der Name muss genau Ihrer Datei entsprechen, einschließlich Groß- und Kleinschreibung.
Den Bot starten und testen
Den Server starten
Klicken Sie im Seitenmenü auf Konsole und dann auf Starten. Beim Start installiert der Server die Pakete aus requirements.txt und führt dann Ihre Datei aus.
Installing requirements from requirements.txt...
Collecting discord.py==2.3.2
Collecting python-dotenv==1.0.0
Successfully installed discord.py-2.3.2 python-dotenv-1.0.0
Running bot.py...
Bot connected as MyBot
Connected to 1 server(s)
Auf Discord prüfen
Die Konsole sollte diese Zeilen anzeigen.
Bot connected as MyBot
Connected to 1 server(s)
Öffnen Sie Discord und gehen Sie auf den Server, auf den Sie den Bot eingeladen haben.
Ihr Bot erscheint online, mit einem grünen Punkt.
Testen Sie den Befehl
!ping. Der Bot antwortet „Pong! Latency: XXms“.
Aus einem Git-Repository bereitstellen
Ihr Code liegt auf GitHub, GitLab, Bitbucket oder Codeberg? Die Seite Bereitstellung holt das Repository und installiert die Pakete aus requirements.txt für Sie, statt dass Sie Dateien von Hand hochladen.
Klicken Sie im Seitenmenü auf Bereitstellung.
Füllen Sie im Block Repository verknüpfen die Felder Repository-Adresse und Branch aus.
Wählen Sie unter Zugriff auf das Repository Öffentliches Repository oder eine der beiden Optionen für private Repositorys (Deploy-Schlüssel oder Zugriffstoken).
Haken Sie Bei jedem Push auf den Branch bereitstellen an, wenn Sie automatische Updates möchten, und klicken Sie auf Speichern.
Klicken Sie auf Jetzt bereitstellen.
Jede Bereitstellung startet den Server neu, der während der Installation der Abhängigkeiten angehalten bleibt. Schlägt die Installation fehl, startet die vorherige Version wieder. Nicht von Git verfolgte Dateien wie Ihre .env bleiben erhalten. Vor der ersten Bereitstellung erstellt das Panel ein Backup des Servers.

Für ein privates Repository wird der Deploy-Schlüssel empfohlen. Das Panel erzeugt einen eigenen Schlüssel für den Server, den Sie dem Repository mit Lesezugriff hinzufügen.
Mehrere Bots mit einem einzigen Angebot starten
Ein Python-Server führt beim Start eine einzige Datei aus. Damit mehrere Bots mit demselben Angebot laufen, kann diese Datei ein Startskript sein, das jeden Bot in einem eigenen Prozess startet. Stürzt ein Bot ab, laufen die anderen weiter. Alle teilen sich den Arbeitsspeicher und den Prozessor des Angebots.
Laden Sie die Dateien Ihrer Bots in das Stammverzeichnis des Servers hoch, zum Beispiel
bot1.pyundbot2.py.Fassen Sie die Pakete aller Bots in der Datei
requirements.txtim Stammverzeichnis zusammen.Geben Sie in der Datei
.envdem Token jedes Bots einen eigenen Namen, etwaDISCORD_TOKEN_1undDISCORD_TOKEN_2. Lassen Sie jeden Bot seinen eigenen Token lesen, zum Beispiel mitbot.run(os.getenv('DISCORD_TOKEN_1')).Erstellen Sie im Stammverzeichnis eine Datei
launcher.pymit dem folgenden Inhalt und passen Sie die ListeBOTSan.Öffnen Sie Konfiguration › Servereinstellungen, tragen Sie
launcher.pyunter Fichier py de démarrage (Startdatei) ein und klicken Sie auf das Häkchen (Speichern).Klicken Sie in der Konsole auf Neu starten.
# Startet jeden Bot in einem eigenen Prozess
import subprocess
import sys
import threading
# Die Dateien Ihrer Bots, im Stammverzeichnis des Servers
BOTS = ["bot1.py", "bot2.py"]
def run(file):
process = subprocess.Popen(
[sys.executable, "-u", file],
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
text=True,
)
# Zeigt jede Zeile des Bots in der Konsole an, mit seinem Namen davor
for line in process.stdout:
print(f"[{file}] {line}", end="", flush=True)
print(f"[{file}] gestoppt (Code {process.wait()})", flush=True)
threads = [threading.Thread(target=run, args=(file,)) for file in BOTS]
for thread in threads:
thread.start()
for thread in threads:
thread.join()
In der Konsole beginnt jede Zeile mit dem Namen des Bots, der sie schreibt, zum Beispiel [bot1.py] Bot connected as MyBot. Wenn ein Bot stoppt, zeigt das Startskript seinen Exit-Code an.
Das Startskript startet einen gestoppten Bot nicht neu. Starten Sie dazu den Server neu.
Fehlerbehebung
Der Bot startet nicht
| Fehler | Lösung |
|---|---|
ModuleNotFoundError: No module named 'discord' | Prüfen Sie requirements.txt und starten Sie neu. |
ModuleNotFoundError: No module named 'dotenv' | Fügen Sie python-dotenv zu requirements.txt hinzu. |
FileNotFoundError: bot.py | Falscher Wert in der Variable Python-Startdatei. |
SyntaxError | Fehler in Ihrem Python-Code. |
Token-Fehler
| Fehler | Lösung |
|---|---|
LoginFailure: Improper token has been passed | Prüfen Sie den Token in .env. |
HTTPException: 401 Unauthorized | Ungültiger Token, erzeugen Sie ihn neu. |
PrivilegedIntentsRequired | Aktivieren Sie die Intents im Discord Developer Portal. |
Der Bot liest keine Nachrichten
| Ursache | Lösung |
|---|---|
| MESSAGE CONTENT INTENT deaktiviert | Aktivieren Sie es im Discord Developer Portal. |
| Intents im Code falsch eingestellt | Fügen Sie intents.message_content = True hinzu. |
Prüfen Sie Ihren Code:
intents = discord.Intents.default()
intents.message_content = True # Diese Zeile ist erforderlich!
Die Datei .env wird nicht gelesen
| Ursache | Lösung |
|---|---|
| python-dotenv fehlt | Prüfen Sie requirements.txt. |
load_dotenv() nicht aufgerufen | Rufen Sie load_dotenv() vor os.getenv() auf. |
| Falscher Dateiname | Die Datei muss genau .env heißen. |
| Falsches Format | Keine Leerzeichen um das =. |
pip install schlägt fehl
| Fehler | Lösung |
|---|---|
requirements.txt not found | Prüfen Sie, ob die Datei im Stammverzeichnis liegt. |
Could not find a version | Prüfen Sie Namen und Versionen der Pakete sowie die gewählte Python-Version. |
Bewährte Vorgehensweisen
Die Datei .env schützen
| Empfohlen | Zu vermeiden |
|---|---|
.env nur auf dem Server aufbewahren | .env weitergeben |
.env direkt in OuiPanel erstellen | Den Token in den Code schreiben |
.env in die .gitignore aufnehmen | .env auf GitHub committen |
Empfohlene .gitignore für Ihr Projekt:
# Umgebungsvariablen
.env
.env.local
# Python
__pycache__/
*.py[cod]
venv/
Sicherheit, Leistung und Code
Geben Sie Ihren Token nie weiter, legen Sie die
.envdirekt auf dem Server an und erzeugen Sie den Token neu, falls er bekannt wird.Aktivieren Sie nur die nötigen Intents.
Nutzen Sie für Befehle
commands.Botstattdiscord.Client.Fangen Sie Fehler mit
try/exceptab und schreiben Sie Logs mitprint()oder dem Modullogging.Teilen Sie große Bots in Cogs auf.
Den Bot mit Cogs strukturieren
Für einen besser strukturierten Bot verteilen Sie die Befehle auf Cogs.
MonBotPython/
├── bot.py ← Einstiegspunkt
├── requirements.txt
├── .env ← Auf dem Server erstellt
├── cogs/
│ ├── moderation.py ← Moderationsbefehle
│ ├── fun.py ← Spaßbefehle
│ └── utility.py ← Hilfsbefehle
└── config.py ← Nicht sensible Konfiguration
Beispiel einer bot.py mit Cogs:
import os
import discord
from discord.ext import commands
from dotenv import load_dotenv
load_dotenv()
intents = discord.Intents.default()
intents.message_content = True
bot = commands.Bot(command_prefix='!', intents=intents)
# Lade die Cogs beim Start
@bot.event
async def on_ready():
print(f'Bot verbunden als {bot.user.name}')
# Lade die Cogs
for filename in os.listdir('./cogs'):
if filename.endswith('.py'):
await bot.load_extension(f'cogs.{filename[:-3]}')
print(f'Cog geladen: {filename}')
bot.run(os.getenv('DISCORD_TOKEN'))
Beispiel eines Cogs (cogs/fun.py):
import discord
from discord.ext import commands
class Fun(commands.Cog):
def __init__(self, bot):
self.bot = bot
@commands.command()
async def ping(self, ctx):
"""Antwortet mit Pong!"""
latency = round(self.bot.latency * 1000)
await ctx.send(f'Pong! Latenz: {latency}ms')
@commands.command()
async def hello(self, ctx):
"""Sagt Hallo"""
await ctx.send(f'Hallo {ctx.author.name}!')
async def setup(bot):
await bot.add_cog(Fun(bot))
Brauchen Sie Hilfe?
Eröffnen Sie ein Ticket über Tickets › Ticket öffnen oder über die Kachel Support kontaktieren unten auf der Seite Ihres Servers im Kundenbereich. Sie können Ihre Frage auch auf dem Discord von OuiHeberg stellen.
Stellen Sie Ihre Python-Anwendungen mit unserem optimierten Hosting und dediziertem Support bereit.
Angebote ansehen →