Meine Slash-Commands werden nicht angezeigt - woran liegt das?

Nach tree.sync() kann es bei global registrierten Befehlen bis zu einer Stunde dauern, bis Discord sie überall anzeigt. Zum Testen kannst du Befehle stattdessen direkt für einen einzelnen Server synchronisieren, damit sie sofort verfügbar sind.

Eigenen Discord Bot mit discord.py programmieren

Q: Mein Bot bleibt offline - was prüfe ich zuerst?

Prüfe, ob der Token in der Umgebungsvariable DISCORD_TOKEN korrekt hinterlegt ist und ob im Dienst-Log eine Fehlermeldung erscheint.

Schritt für Schritt einen eigenen Discord-Bot mit Python und discord.py schreiben und auf ZapX deployen.

28. Oktober 20263 Min. Lesezeit0 Aufrufe0 hilfreich

Einleitung

In dieser Anleitung baust du einen eigenen Discord-Bot von Grund auf mit Python und der Bibliothek discord.py. Du registrierst die Bot-Anwendung im Discord Developer Portal, schreibst ein funktionierendes Grundgerüst mit einem eigenen Slash-Command und deployst den fertigen Bot anschließend auf deinem ZapX Discord-Bot-Hosting. Grundkenntnisse in Python sind hilfreich, aber keine Voraussetzung.

Vorbereitung

Bevor du mit dem Code startest, brauchst du eine Bot-Anwendung bei Discord:

Öffne das Discord Developer Portal und klicke auf New Application. Vergib einen Namen für deinen Bot.
Wechsle im Menü links zum Reiter Bot. Hier findest du den Token deines Bots über Reset Token. Kopiere den Token und bewahre ihn sicher auf – er ermöglicht vollen Zugriff auf deinen Bot und darf niemals in deinem Code oder öffentlich geteilt werden.
Aktiviere auf derselben Seite unter Privileged Gateway Intents den Punkt Message Content Intent, falls dein Bot auf Nachrichteninhalte reagieren soll (z. B. bei textbasierten Befehlen).
Wechsle zum Reiter OAuth2 → URL Generator. Wähle den Scope bot sowie zusätzlich applications.commands (für Slash-Commands), setze darunter die Berechtigungen, die dein Bot benötigt, und öffne den generierten Link, um den Bot auf deinen eigenen Discord-Server einzuladen.

Den Bot in Python schreiben

Installiere zunächst discord.py in deiner Entwicklungsumgebung:

bash

pip install -U discord.py

Lege eine Datei main.py an und baue das Grundgerüst deines Bots auf:

python

import os
import discord
from discord import app_commands

intents = discord.Intents.default()
intents.message_content = True

client = discord.Client(intents=intents)
tree = app_commands.CommandTree(client)


@client.event
async def on_ready():
    await tree.sync()
    print(f"Bot ist online als {client.user}")


@tree.command(name="hallo", description="Begrüßt dich mit einer kurzen Nachricht")
async def hallo(interaction: discord.Interaction):
    await interaction.response.send_message(f"Hallo {interaction.user.mention}!")


client.run(os.environ["DISCORD_TOKEN"])

Der Token wird hier bewusst nicht als fester Text im Code hinterlegt, sondern über die Umgebungsvariable DISCORD_TOKEN eingelesen (os.environ["DISCORD_TOKEN"]). Das hält den Token aus deinem Code heraus und ist die Grundlage für den Deploy-Schritt weiter unten.

Möchtest du zusätzlich auf neue Servermitglieder reagieren, etwa mit einer Willkommensnachricht, ergänzt du einen weiteren Event-Handler:

python

@client.event
async def on_member_join(member: discord.Member):
    channel = discord.utils.get(member.guild.text_channels, name="willkommen")
    if channel:
        await channel.send(f"Willkommen auf dem Server, {member.mention}!")

Den Bot auf ZapX Discord-Bot-Hosting deployen

Lege im ZapX Kundenpanel einen neuen Discord-Bot-Dienst an, falls noch nicht geschehen.
Wähle bei der Konfiguration als Runtime Python 3.12.
Lade deine main.py (und, falls vorhanden, eine requirements.txt mit zusätzlichen Paketen) entweder über den integrierten Dateimanager oder per Datei-Upload in das Dienstverzeichnis hoch.

Trage den zuvor erzeugten Bot-Token im Tab Einstellungen unter Bot-Konfiguration → Discord Bot Token ein und speichere die Einstellungen – dadurch bleibt dein Token getrennt vom Code und muss bei einem erneuten Upload nicht angepasst werden. Im Hintergrund steht dir dieser Wert in deinem Code weiterhin als Umgebungsvariable DISCORD_TOKEN zur Verfügung.

ZapX Discord Bot Einstellungen mit Token-Feld

5. Starte den Dienst. Läuft alles korrekt, meldet sich dein Bot im Log mit Bot ist online als ... und erscheint als "Online" auf deinem Discord-Server.

Fehlerbehebung

Der Bot bleibt offline: Prüfe, ob der Token in der Umgebungsvariable DISCORD_TOKEN korrekt hinterlegt ist und ob im Dienst-Log eine Fehlermeldung erscheint.

Slash-Commands werden nicht angezeigt: Nach tree.sync() kann es bei global registrierten Befehlen bis zu einer Stunde dauern, bis Discord sie überall anzeigt. Zum Testen synchronisierst du Befehle stattdessen direkt für einen einzelnen Server, damit sie sofort verfügbar sind.

"Missing Access" oder ähnliche Berechtigungsfehler: Der Bot hat auf dem Server nicht die nötigen Rechte. Prüfe die Rollenberechtigungen des Bots und ob beim Einladen die passenden Berechtigungen im OAuth2 URL Generator gesetzt waren.

Abschluss

Du hast jetzt einen eigenen, funktionsfähigen Discord-Bot mit discord.py geschrieben, mit einem eigenen Slash-Command ausgestattet und auf deinem ZapX Discord-Bot-Hosting deployt. Von hier aus kannst du den Bot beliebig um weitere Befehle, Moderationsfunktionen oder Integrationen erweitern.

FAQ

Häufig gestellte Fragen

Eine Bot-Anwendung im Discord Developer Portal: dort erstellst du eine New Application, holst dir im Bot-Reiter den Token über 'Reset Token' und generierst im OAuth2-URL-Generator (Scopes 'bot' und 'applications.commands') den Einladungslink für deinen Server.

Der Token wird bewusst nicht fest im Code hinterlegt, sondern über die Umgebungsvariable DISCORD_TOKEN eingelesen ('os.environ["DISCORD_TOKEN"]'). Im ZapX Discord-Bot-Hosting trägst du ihn im Tab Einstellungen unter Bot-Konfiguration -> Discord Bot Token ein.

Python 3.12.

Feedback

War dieser Artikel hilfreich?

Deine Rückmeldung hilft uns, Inhalte besser zu priorisieren und zu überarbeiten.

0 von 0 Rückmeldungen fanden diesen Artikel hilfreich.

Persönliche Hilfe

Die Anleitung reicht nicht?

Unser ZAP-Support kennt dein Produkt — beschreib kurz dein Anliegen und wir helfen dir persönlich weiter.

Welche 🍪 Cookies dürfen es für dich sein?

Eigenen Discord Bot mit discord.py programmieren

Einleitung

Vorbereitung

Den Bot in Python schreiben

Den Bot auf ZapX Discord-Bot-Hosting deployen

Fehlerbehebung

Abschluss

Häufig gestellte Fragen

Discord-Bot

Vorbereitung

Den Bot in Python schreiben

Den Bot auf ZapX Discord-Bot-Hosting deployen

Fehlerbehebung

Abschluss

Gameserver

Server & Hosting

ZAPX

Ressourcen

ZAP-Hosting