PythonVeröffentlicht am 15. Dezember 202511 Min. Lesezeit

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

  1. Öffnen Sie das Discord Developer Portal und melden Sie sich mit Ihrem Discord-Konto an.

  2. Klicken Sie auf New Application.

  3. Geben Sie Ihrer Anwendung einen Namen, zum Beispiel „Mein Python-Bot“, akzeptieren Sie die Nutzungsbedingungen und klicken Sie auf Create.

Fenster Create an application im Discord Developer Portal mit dem Namen des Bots

Den Token abrufen

Der Token ist der geheime Schlüssel, mit dem sich Ihr Code mit dem Bot verbindet.

  1. Suchen Sie im Bereich Bot das Feld TOKEN und klicken Sie auf Reset Token.

  2. Bestätigen Sie im Fenster mit Yes, do it!

  3. Klicken Sie auf Copy, um den Token zu kopieren, und bewahren Sie ihn für die nächsten Schritte sicher auf.

Bereich Bot im Discord Developer Portal mit der Schaltfläche Reset Token

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.

IntentBeschreibungEmpfehlung
PRESENCE INTENTStatus der Mitglieder sehenOptional
SERVER MEMBERS INTENTAuf die Mitgliederliste zugreifenOptional
MESSAGE CONTENT INTENTNachrichteninhalte lesenErforderlich

Bereich Privileged Gateway Intents im Discord Developer Portal mit den drei Schaltern

Ohne MESSAGE CONTENT INTENT kann Ihr Bot die Inhalte der Nachrichten Ihrer Nutzer nicht lesen.

Den Bot auf Ihren Discord-Server einladen

  1. Klicken Sie im linken Menü auf OAuth2 und dann auf URL Generator.

  2. Haken Sie unter SCOPES bot an (und applications.commands für Slash-Befehle).

  3. Wählen Sie unter BOT PERMISSIONS die nötigen Berechtigungen (siehe Tabelle).

  4. Kopieren Sie unten auf der Seite die erzeugte URL und öffnen Sie sie im Browser.

  5. Wählen Sie den Server aus, klicken Sie auf Autorisieren und lösen Sie das Captcha, falls verlangt.

BerechtigungBeschreibung
AdministratorAlle Berechtigungen (einfach, aber weitreichend)
Send MessagesNachrichten senden
Read Message HistoryDen Verlauf lesen
Embed LinksEmbeds senden
Attach FilesDateien senden
Use Slash CommandsSlash-Befehle nutzen

Wählen Sie Administrator oder nur die Berechtigungen, die Ihr Bot wirklich braucht.

Liste Bot Permissions des URL Generator mit angehaktem Administrator

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

Discord-Fenster zur Autorisierung des Bots mit der Auswahl des Servers


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 Sie os.getenv() verwenden.


Die Dateien zu OuiPanel hochladen

Der Dateimanager hat keine Upload-Schaltfläche. Dateien werden per Drag-and-drop gesendet.

  1. Melden Sie sich unter dash.ouipanel.com bei OuiPanel an und öffnen Sie Ihren Python-Server.

  2. Klicken Sie im Seitenmenü auf Dateimanager.

  3. Löschen Sie gegebenenfalls die Standarddateien.

  4. Ziehen Sie bot.py, requirements.txt und Ihre Ordner (cogs/…) von Ihrem Computer auf die Seite.

  5. Sobald die Ebene „Dateien hier ablegen“ erscheint, lassen Sie los.

Jede so gesendete Datei ist auf 100 MB begrenzt.

Ebene Dateien hier ablegen während eines Drag-and-drop im Dateimanager

Laden Sie Ihre Datei .env nicht 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.

  1. Klicken Sie im Dateimanager, im Stammverzeichnis, auf Datei erstellen.

  2. Geben Sie im Fenster „Neue Datei erstellen“ unter Dateiname .env ein, mit dem Punkt am Anfang, und klicken Sie auf Datei erstellen.

  3. Klicken Sie auf .env, um die Datei im Editor zu öffnen, und fügen Sie den Inhalt unten ein.

  4. Ersetzen Sie your_token_here durch 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.

Dateimanager im Stammverzeichnis eines Python-Bots mit bot.py, requirements.txt und dem Ordner cogs

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.

  1. Öffnen Sie Konfiguration › Servereinstellungen.

  2. 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.

  3. Tragen Sie in der Karte Umgebungsvariablen den Namen Ihrer Datei unter Python-Startdatei ein (Startdatei; die Variablennamen erscheinen auf Französisch).

  4. Klicken Sie auf das Häkchen rechts neben dem Feld (Speichern).

Ihre HauptdateiWert von Python-Startdatei
bot.pybot.py
main.pymain.py
index.pyindex.py
app.pyapp.py
src/bot.pysrc/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.

Umgebungsvariablen eines Python-Servers mit Python-Startdatei und Abhängigkeitsdatei

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)
  1. Öffnen Sie Discord und gehen Sie auf den Server, auf den Sie den Bot eingeladen haben.

  2. Ihr Bot erscheint online, mit einem grünen Punkt.

  3. 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.

  1. Klicken Sie im Seitenmenü auf Bereitstellung.

  2. Füllen Sie im Block Repository verknüpfen die Felder Repository-Adresse und Branch aus.

  3. Wählen Sie unter Zugriff auf das Repository Öffentliches Repository oder eine der beiden Optionen für private Repositorys (Deploy-Schlüssel oder Zugriffstoken).

  4. Haken Sie Bei jedem Push auf den Branch bereitstellen an, wenn Sie automatische Updates möchten, und klicken Sie auf Speichern.

  5. 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.

Seite Git-Bereitstellung mit Repository verknüpfen, Repository-Adresse, Branch und Zugriff auf das Repository

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.

  1. Laden Sie die Dateien Ihrer Bots in das Stammverzeichnis des Servers hoch, zum Beispiel bot1.py und bot2.py.

  2. Fassen Sie die Pakete aller Bots in der Datei requirements.txt im Stammverzeichnis zusammen.

  3. Geben Sie in der Datei .env dem Token jedes Bots einen eigenen Namen, etwa DISCORD_TOKEN_1 und DISCORD_TOKEN_2. Lassen Sie jeden Bot seinen eigenen Token lesen, zum Beispiel mit bot.run(os.getenv('DISCORD_TOKEN_1')).

  4. Erstellen Sie im Stammverzeichnis eine Datei launcher.py mit dem folgenden Inhalt und passen Sie die Liste BOTS an.

  5. Öffnen Sie Konfiguration › Servereinstellungen, tragen Sie launcher.py unter Fichier py de démarrage (Startdatei) ein und klicken Sie auf das Häkchen (Speichern).

  6. 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

FehlerLö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.pyFalscher Wert in der Variable Python-Startdatei.
SyntaxErrorFehler in Ihrem Python-Code.

Token-Fehler

FehlerLösung
LoginFailure: Improper token has been passedPrüfen Sie den Token in .env.
HTTPException: 401 UnauthorizedUngültiger Token, erzeugen Sie ihn neu.
PrivilegedIntentsRequiredAktivieren Sie die Intents im Discord Developer Portal.

Der Bot liest keine Nachrichten

UrsacheLösung
MESSAGE CONTENT INTENT deaktiviertAktivieren Sie es im Discord Developer Portal.
Intents im Code falsch eingestelltFü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

UrsacheLösung
python-dotenv fehltPrüfen Sie requirements.txt.
load_dotenv() nicht aufgerufenRufen Sie load_dotenv() vor os.getenv() auf.
Falscher DateinameDie Datei muss genau .env heißen.
Falsches FormatKeine Leerzeichen um das =.

pip install schlägt fehl

FehlerLösung
requirements.txt not foundPrüfen Sie, ob die Datei im Stammverzeichnis liegt.
Could not find a versionPrüfen Sie Namen und Versionen der Pakete sowie die gewählte Python-Version.

Bewährte Vorgehensweisen

Die Datei .env schützen

EmpfohlenZu vermeiden
.env nur auf dem Server aufbewahren.env weitergeben
.env direkt in OuiPanel erstellenDen 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 .env direkt 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.Bot statt discord.Client.

  • Fangen Sie Fehler mit try/except ab und schreiben Sie Logs mit print() oder dem Modul logging.

  • 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.

War dieser Artikel hilfreich?

463 Aufrufe
Diesen Artikel teilen
Python
Python-Hosting benötigt?

Stellen Sie Ihre Python-Anwendungen mit unserem optimierten Hosting und dediziertem Support bereit.

Angebote ansehen →

Verwandte Artikel