Einen Discord-Bot (discord.js) auf OuiPanel hosten
Diese Anleitung zeigt, wie Sie einen Discord-Bot mit discord.js (JavaScript, Node.js) auf einem Node.js-Server von OuiHeberg hosten, den Sie in OuiPanel verwalten. 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 und die Dateien des Bots (index.js, package.json…).
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 Bot“, akzeptieren Sie die Bedingungen und klicken Sie auf Create.

Den Bot erstellen
Klicken Sie im linken Menü auf Bot. Neue Anwendungen haben ihren Bot bereits. Erscheint die Schaltfläche Add Bot, klicken Sie darauf und bestätigen Sie im Fenster mit Yes, do it!
Den Token abrufen
Klicken Sie im Bereich Bot auf Reset Token.
Bestätigen Sie und kopieren Sie den angezeigten Token.
Der Token ist wie ein Passwort. Wer ihn hat, kann Ihren Bot steuern. Geben Sie ihn nie weiter und legen Sie ihn nie in öffentlichen Code (GitHub usw.).
Die Intents aktivieren
Scrollen Sie im Bereich Bot zu Privileged Gateway Intents und aktivieren Sie die nötigen Intents.
| Intent | Nutzen |
|---|---|
| PRESENCE INTENT | Optional |
| SERVER MEMBERS INTENT | Optional |
| MESSAGE CONTENT INTENT | Erforderlich, um Nachrichteninhalte zu lesen |

Ohne MESSAGE CONTENT INTENT kann Ihr Bot keine Nachrichteninhalte lesen, und ein Befehl wie
!pingbleibt ohne Antwort.
Den Bot auf Ihren Discord-Server einladen
Klicken Sie im linken Menü auf OAuth2 › URL Generator.
Haken Sie unter Scopes bot und applications.commands an.
Wählen Sie unter Bot Permissions die nötigen Berechtigungen, oder Administrator für alle.
Kopieren Sie die unten erzeugte URL, öffnen Sie sie und laden Sie den Bot auf Ihren Discord-Server ein.

Die Dateien des Bots vorbereiten
Dateistruktur
Ihr Bot sollte diese Struktur haben.
MeinBot/
├── index.js ← Hauptdatei (oder bot.js, main.js...)
├── package.json ← npm-Abhängigkeiten
├── .env ← Bot-Token (auf dem Server erstellt)
├── commands/ ← (Optional) Ordner für Befehle
└── events/ ← (Optional) Ordner für Ereignisse
Die Datei package.json
Legen Sie eine Datei package.json mit den Abhängigkeiten discord.js und dotenv an.
{
"name": "mein-discord-bot",
"version": "1.0.0",
"description": "Mein Discord-Bot",
"main": "index.js",
"scripts": {
"start": "node index.js"
},
"dependencies": {
"discord.js": "^14.14.1",
"dotenv": "^16.3.1"
}
}
Passen Sie
"main": "index.js"an den Namen Ihrer Hauptdatei an (bot.js,main.jsusw.).
Die Hauptdatei (index.js)
Legen Sie Ihre Hauptdatei an. Sie lädt den Token mit dotenv.
// Umgebungsvariablen aus .env laden
require('dotenv').config();
const { Client, GatewayIntentBits } = require('discord.js');
// Discord-Client erstellen
const client = new Client({
intents: [
GatewayIntentBits.Guilds,
GatewayIntentBits.GuildMessages,
GatewayIntentBits.MessageContent
]
});
// Ereignis: Bot bereit
client.once('ready', () => {
console.log(`Bot verbunden als ${client.user.tag}`);
});
// Ereignis: Nachricht erhalten
client.on('messageCreate', message => {
if (message.author.bot) return;
// Prefix aus .env verwenden (optional)
const prefix = process.env.PREFIX || '!';
if (message.content === `${prefix}ping`) {
message.reply('Pong!');
}
});
// Fehlerbehandlung
process.on('unhandledRejection', error => {
console.error('Unerwarteter Fehler:', error);
});
client.on('error', error => {
console.error('Discord-Fehler:', error);
});
// Mit dem Token aus .env verbinden
client.login(process.env.DISCORD_TOKEN);
Die Zeile
require('dotenv').config();muss die erste Zeile Ihrer Datei sein.
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 Node.js-Server.
Klicken Sie im Seitenmenü auf Dateimanager.
Löschen Sie gegebenenfalls die Standarddateien.
Ziehen Sie
index.js,package.jsonund Ihre Ordner (commands/,events/…) 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.
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
ihr_token_hierdurch Ihren Token und klicken Sie auf Speichern.
# Token des Discord-Bots
DISCORD_TOKEN=ihr_token_hier
# Präfix der Befehle (optional)
PREFIX=!
Beispiel mit einem echten Token:
DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
PREFIX=!
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.
Stammverzeichnis des Servers/
├── .env ← Enthält DISCORD_TOKEN
├── index.js ← Ihr Code
├── package.json ← Abhängigkeiten
└── node_modules/ ← (automatisch erstellt)
Hauptdatei und Node.js-Version festlegen
OuiPanel muss wissen, welche Datei beim Start ausgeführt wird. Auf einem Node.js-Server ist das eine Servervariable.
Öffnen Sie Konfiguration › Servereinstellungen.
Prüfen Sie in der Karte Serverstart die Systemversion. Die Liste bietet Node.js 12, 14 und alle Versionen von 16 bis 26. Version 24, die LTS-Version, passt zu discord.js.
Tragen Sie in der Karte Umgebungsvariablen den Namen Ihrer Datei unter Hauptdatei ein (Hauptdatei; die Variablennamen erscheinen auf Französisch).
Klicken Sie auf das Häkchen rechts neben dem Feld (Speichern).
| Ihre Hauptdatei | Wert von Hauptdatei |
|---|---|
index.js | index.js |
bot.js | bot.js |
main.js | main.js |
src/index.js | src/index.js |
app.js | app.js |
Dieselbe Karte bietet Zusätzliche Node-Pakete und Zu deinstallierende Node-Pakete, um npm-Pakete hinzuzufügen oder zu entfernen (Namen durch Leerzeichen getrennt). Das Feld Zusätzliche Argumente übergibt Optionen an Node.js.

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 Abhängigkeiten aus package.json mit npm install und führt dann Ihre Datei aus.
> npm install
added 45 packages in 3s
> node index.js
Bot verbunden als MeinBot#1234
Auf Discord prüfen
Die Konsole sollte diese Zeile anzeigen.
Bot verbunden als MeinBot#1234
Öffnen Sie Discord. Ihr Bot erscheint online, mit einem grünen Punkt.
Testen Sie den Befehl
!ping. Der Bot antwortet „Pong!“.
Aus einem Git-Repository bereitstellen
Ihr Code liegt auf GitHub, GitLab, Bitbucket oder Codeberg? Die Seite Bereitstellung holt das Repository und installiert die Abhängigkeiten 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 Node.js-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.jsundbot2.js.Fassen Sie die Abhängigkeiten aller Bots in der Datei
package.jsonim 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 mitclient.login(process.env.DISCORD_TOKEN_1).Erstellen Sie im Stammverzeichnis eine Datei
launcher.jsmit dem folgenden Inhalt und passen Sie die Listebotsan.Öffnen Sie Konfiguration › Servereinstellungen, tragen Sie
launcher.jsunter Fichier principal (Hauptdatei) ein und klicken Sie auf das Häkchen (Speichern).Klicken Sie in der Konsole auf Neu starten.
// Startet jeden Bot in einem eigenen Prozess
const { spawn } = require('child_process');
const readline = require('readline');
// Die Dateien Ihrer Bots, im Stammverzeichnis des Servers
const bots = ['bot1.js', 'bot2.js'];
for (const file of bots) {
const child = spawn(process.execPath, [file]);
// Zeigt jede Zeile des Bots in der Konsole an, mit seinem Namen davor
readline.createInterface({ input: child.stdout })
.on('line', (line) => console.log(`[${file}] ${line}`));
readline.createInterface({ input: child.stderr })
.on('line', (line) => console.error(`[${file}] ${line}`));
child.on('exit', (code) => console.log(`[${file}] gestoppt (Code ${code})`));
}
In der Konsole beginnt jede Zeile mit dem Namen des Bots, der sie schreibt, zum Beispiel [bot1.js] Bot verbunden als MeinBot#1234. 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 |
|---|---|
Cannot find module 'discord.js' | Prüfen Sie package.json und starten Sie neu. |
Cannot find module 'dotenv' | Fügen Sie dotenv zu package.json hinzu. |
Error: Cannot find module './index.js' | Falscher Wert in der Variable Hauptdatei. |
ENOENT: no such file or directory | Die angegebene Datei existiert nicht. |
Token-Fehler
| Fehler | Lösung |
|---|---|
An invalid token was provided | Prüfen Sie den Token in .env. |
TOKEN_INVALID | Erzeugen Sie den Token im Discord Developer Portal neu. |
Used disallowed intents | 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. |
| Falsche Intents im Code | Fügen Sie GatewayIntentBits.MessageContent hinzu. |
Die Datei .env wird nicht gelesen
| Ursache | Lösung |
|---|---|
| dotenv fehlt | Prüfen Sie, ob es in package.json steht. |
require an der falschen Stelle | require('dotenv').config(); muss die erste Zeile sein. |
| Falscher Dateiname | Die Datei muss genau .env heißen. |
npm install schlägt fehl
| Fehler | Lösung |
|---|---|
package.json not found | Prüfen Sie, ob die Datei im Stammverzeichnis liegt. |
ERESOLVE unable to resolve | Aktualisieren Sie die Versionen in package.json. |
Bewährte Vorgehensweisen
Die Datei .env schützen
| Empfohlen | Zu vermeiden |
|---|---|
.env nur auf dem Server aufbewahren | .env weitergeben |
.env direkt in OuiPanel erstellen | .env vom eigenen Computer hochladen |
.env in die .gitignore aufnehmen | .env auf GitHub committen |
Empfohlene .gitignore für Ihr Projekt:
# Umgebungsvariablen
.env
# Node modules
node_modules/
Sicherheit und Leistung
Geben Sie Ihren Token nie weiter und erzeugen Sie ihn neu, falls er bekannt wird.
Legen Sie die
.envdirekt auf dem Server an.Aktivieren Sie nur die nötigen Intents.
Fangen Sie Fehler mit
try/catchab und schreiben Sie Logs zur Fehlersuche.
Einen größeren Bot strukturieren
Für einen besser strukturierten Bot trennen Sie Befehle und Ereignisse.
MeinBot/
├── index.js ← Einstiegspunkt
├── package.json
├── .env ← Auf dem Server erstellt
├── commands/
│ ├── ping.js
│ ├── help.js
│ └── info.js
├── events/
│ ├── ready.js
│ └── messageCreate.js
└── config.json ← Nicht sensible Konfiguration
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 Node.js-Anwendungen mit unserem optimierten Hosting und dediziertem Support bereit.
Angebote ansehen →