StartAnleitungenDiscord-Bots und Apps

Typische Fehler: falsche Node-Version, fehlende Intents, falsche Startdatei

Die fünf Einrichtungsfehler hinter den meisten Bot-Tickets und die Einzeiler-Lösung für jeden.

1 Min. LesezeitStand 2026-09-14Read this guide in English →
  1. Falsche Node-Version. SyntaxError: Unexpected token bei moderner Syntax oder eine Bibliothek, die nicht lädt: Docker-Image in Startup auf Node 20 oder 22 stellen, neu starten.
  2. Fehlende Intents. Der Bot startet, sieht aber nie Nachrichten: Message Content Intent (und Server Members, falls nötig) im Developer Portal aktivieren und die Intents beim Erzeugen des Clients übergeben.
  3. Falsche Startdatei. Cannot find module '/home/container/index.js': MAIN_FILE / PY_FILE auf deine echte Einstiegsdatei setzen, inklusive src/-Präfix, falls vorhanden.
  4. Token im Code, Code auf GitHub. Discord setzt den Token automatisch zurück, wenn es ein Leak erkennt, und dein Bot stirbt mit invalid token. In .env verschieben.
  5. Bot online, aber Befehle tun nichts. Slash-Befehle müssen einmal registriert werden (REST.put(Routes.applicationCommands(...)) in discord.js, tree.sync() in discord.py). Globale Befehle brauchen bis zu einer Stunde; Guild-Befehle sind sofort da.

Bonus: "Cannot send messages to this user" heißt, dass der Nutzer seine DMs geschlossen hat; den Fehler abfangen statt abzustürzen.