Cómo alojar un bot de Discord (discord.js) en OuiPanel
Esta guía te explica cómo alojar un bot de Discord escrito con discord.js (JavaScript, Node.js) en un servidor Node.js de OuiHeberg, que gestionas en OuiPanel. El bot funciona sin parar en el servidor, aunque tu ordenador esté apagado. Necesitas un bot creado en el Portal de desarrolladores de Discord, su token y los archivos del bot (index.js, package.json…).
Crear el bot en Discord
¿Ya tienes tu bot y su token? Pasa a la siguiente sección.
Crear la aplicación
Ve al Portal de desarrolladores de Discord e inicia sesión con tu cuenta de Discord.
Haz clic en New Application.
Pon un nombre a tu aplicación, por ejemplo «Mi Bot», acepta las condiciones y haz clic en Create.

Crear el bot
En el menú de la izquierda, haz clic en Bot. Las aplicaciones recientes ya tienen su bot. Si aparece el botón Add Bot, haz clic en él y confirma con Yes, do it! en la ventana.
Obtener el token
En la sección Bot, haz clic en Reset Token.
Confirma y copia el token que aparece.
El token es como una contraseña. Quien lo tenga puede controlar tu bot. No lo compartas nunca ni lo pongas en código público (GitHub, etc.).
Activar los intents
En la misma sección Bot, baja hasta Privileged Gateway Intents y activa los intents que necesites.
| Intent | Uso |
|---|---|
| PRESENCE INTENT | Opcional |
| SERVER MEMBERS INTENT | Opcional |
| MESSAGE CONTENT INTENT | Obligatorio para leer el contenido de los mensajes |

Sin MESSAGE CONTENT INTENT, tu bot no puede leer el contenido de los mensajes, y un comando como
!pingse queda sin respuesta.
Invitar el bot a tu servidor de Discord
En el menú de la izquierda, haz clic en OAuth2 › URL Generator.
En Scopes, marca bot y applications.commands.
En Bot Permissions, marca los permisos necesarios, o Administrator para todos.
Copia la URL generada al pie de la página, ábrela e invita el bot a tu servidor de Discord.

Preparar los archivos del bot
Estructura de archivos
Tu bot debe tener esta estructura.
MiBot/
├── index.js ← Archivo principal (o bot.js, main.js...)
├── package.json ← Dependencias npm
├── .env ← Token del bot (creado en el servidor)
├── commands/ ← (Opcional) Carpeta de comandos
└── events/ ← (Opcional) Carpeta de eventos
El archivo package.json
Crea un archivo package.json con las dependencias discord.js y dotenv.
{
"name": "mi-bot-discord",
"version": "1.0.0",
"description": "Mi bot Discord",
"main": "index.js",
"scripts": {
"start": "node index.js"
},
"dependencies": {
"discord.js": "^14.14.1",
"dotenv": "^16.3.1"
}
}
Adapta
"main": "index.js"al nombre de tu archivo principal (bot.js,main.js, etc.).
El archivo principal (index.js)
Crea tu archivo principal. Carga el token con dotenv.
// Cargar las variables de entorno desde .env
require('dotenv').config();
const { Client, GatewayIntentBits } = require('discord.js');
// Creación del cliente Discord
const client = new Client({
intents: [
GatewayIntentBits.Guilds,
GatewayIntentBits.GuildMessages,
GatewayIntentBits.MessageContent
]
});
// Evento: Bot listo
client.once('ready', () => {
console.log(`Bot conectado como ${client.user.tag}`);
});
// Evento: Mensaje recibido
client.on('messageCreate', message => {
if (message.author.bot) return;
// Usar el prefijo desde .env (opcional)
const prefix = process.env.PREFIX || '!';
if (message.content === `${prefix}ping`) {
message.reply('¡Pong!');
}
});
// Manejo de errores
process.on('unhandledRejection', error => {
console.error('Error no manejado:', error);
});
client.on('error', error => {
console.error('Error de Discord:', error);
});
// Conexión con el token desde .env
client.login(process.env.DISCORD_TOKEN);
La línea
require('dotenv').config();debe ser la primera de tu archivo.
Subir los archivos a OuiPanel
El Gestor de archivos no tiene botón de subida. Los archivos se envían arrastrándolos y soltándolos.
Inicia sesión en OuiPanel en dash.ouipanel.com y abre tu servidor Node.js.
En el menú lateral, haz clic en Gestor de archivos.
Borra los archivos por defecto, si los hay.
Desde tu ordenador, arrastra a la página
index.js,package.jsony tus carpetas (commands/,events/…).Cuando aparezca la capa «Arrastra tus archivos aquí», suelta.
Cada archivo enviado así está limitado a 100 MB.

No subas tu archivo
.env. Lo vas a crear directamente en el servidor en el siguiente paso.
Por SFTP
Para muchos archivos, o archivos de más de 100 MB, usa el SFTP. Conéctate con FileZilla, arrastra todo el contenido de la carpeta de tu bot y comprueba que todo ha llegado. La guía FileZilla y SFTP: cómo conectarte a tu servidor de juego explica la conexión.
Crear el archivo .env
No pongas nunca tu token directamente en el código. Crea un archivo .env en el servidor.
En el Gestor de archivos, en la Raíz, haz clic en Crear un archivo.
En la ventana «Crear un nuevo archivo», escribe
.enven Nombre del archivo, con el punto delante, y haz clic en Crear el archivo.Haz clic en
.envpara abrirlo en el editor y pega el contenido de abajo.Cambia
tu_token_aquipor tu token y haz clic en Guardar.
# Token del bot Discord
DISCORD_TOKEN=tu_token_aqui
# Prefijo de comandos (opcional)
PREFIX=!
Ejemplo con un token real:
DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
PREFIX=!
Sin espacios alrededor del
=.Sin comillas alrededor de los valores.
No compartas nunca este archivo.

Esta es la estructura final en el servidor.
Raíz del servidor/
├── .env ← Contiene DISCORD_TOKEN
├── index.js ← Tu código
├── package.json ← Dependencias
└── node_modules/ ← (creado automáticamente)
Elegir el archivo principal y la versión de Node.js
OuiPanel tiene que saber qué archivo lanzar al arrancar. En un servidor Node.js, este ajuste es una variable del servidor.
Abre Configuración › Parámetros del servidor.
En la tarjeta Lanzamiento del servidor, comprueba la Versión del sistema. La lista ofrece Node.js 12, 14 y todas las versiones de la 16 a la 26. La 24, versión LTS, sirve para discord.js.
En la tarjeta Variables de entorno, escribe el nombre de tu archivo en Archivo principal (archivo principal; los nombres de las variables aparecen en francés).
Haz clic en la marca a la derecha del campo (Guardar).
| Tu archivo principal | Valor de Archivo principal |
|---|---|
index.js | index.js |
bot.js | bot.js |
main.js | main.js |
src/index.js | src/index.js |
app.js | app.js |
La misma tarjeta ofrece Paquetes de Node adicionales y Paquetes de Node que desinstalar, para añadir o quitar paquetes npm (nombres separados por espacios). El campo Argumentos adicionales pasa opciones a Node.js.

El nombre debe coincidir exactamente con tu archivo, mayúsculas incluidas.
Arrancar y probar el bot
Iniciar el servidor
En el menú lateral, haz clic en Consola y luego en Iniciar. Al arrancar, el servidor instala las dependencias de package.json con npm install y después lanza tu archivo.
> npm install
added 45 packages in 3s
> node index.js
Bot conectado como MiBot#1234
Comprobar en Discord
La consola debe mostrar esta línea.
Bot conectado como MiBot#1234
Abre Discord. Tu bot aparece en línea, con un punto verde.
Prueba el comando
!ping. El bot responde «¡Pong!».
Desplegar desde un repositorio Git
¿Tu código está en GitHub, GitLab, Bitbucket o Codeberg? La página Despliegue descarga el repositorio e instala las dependencias por ti, en lugar de subir los archivos a mano.
En el menú lateral, haz clic en Despliegue.
En el bloque Vincular un repositorio, rellena Dirección del repositorio y Rama.
En Acceso al repositorio, elige Repositorio público o una de las dos opciones de repositorio privado (clave de despliegue o token de acceso).
Marca Desplegar en cada push a la rama si quieres actualizaciones automáticas y haz clic en Guardar.
Haz clic en Desplegar ahora.
Cada despliegue reinicia el servidor, que queda detenido mientras se instalan las dependencias. Si la instalación falla, vuelve a arrancar la versión anterior. Los archivos no seguidos por Git, como tu .env, se mantienen. Antes del primer despliegue, el panel hace una copia de seguridad del servidor.

Para un repositorio privado se recomienda la clave de despliegue. El panel genera una clave propia del servidor, que añades al repositorio en solo lectura.
Ejecutar varios bots con una sola oferta
Un servidor Node.js lanza un solo archivo al arrancar. Para ejecutar varios bots con la misma oferta, ese archivo puede ser un lanzador que arranca cada bot en su propio proceso. Si un bot falla, los demás siguen funcionando. Todos comparten la memoria y el procesador de la oferta.
Sube los archivos de tus bots a la raíz del servidor, por ejemplo
bot1.jsybot2.js.Reúne las dependencias de todos los bots en el
package.jsonde la raíz.En el archivo
.env, da un nombre distinto al token de cada bot, comoDISCORD_TOKEN_1yDISCORD_TOKEN_2. Haz que cada bot lea el suyo, por ejemplo conclient.login(process.env.DISCORD_TOKEN_1).En la raíz, crea un archivo
launcher.jscon el contenido de abajo y adapta la listabots.En Configuración › Parámetros del servidor, escribe
launcher.jsen Fichier principal (archivo principal) y haz clic en la marca (Guardar).En la Consola, haz clic en Reiniciar.
// Lanza cada bot en su propio proceso
const { spawn } = require('child_process');
const readline = require('readline');
// Los archivos de tus bots, en la raíz del servidor
const bots = ['bot1.js', 'bot2.js'];
for (const file of bots) {
const child = spawn(process.execPath, [file]);
// Muestra cada línea del bot en la consola, precedida de su nombre
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}] detenido (código ${code})`));
}
En la consola, cada línea empieza por el nombre del bot que la escribe, por ejemplo [bot1.js] Bot conectado como MiBot#1234. Cuando un bot se detiene, el lanzador muestra su código de salida.
El lanzador no vuelve a arrancar un bot que se detiene. Para relanzarlo, reinicia el servidor.
Resolver un problema
El bot no arranca
| Error | Solución |
|---|---|
Cannot find module 'discord.js' | Revisa package.json y reinicia. |
Cannot find module 'dotenv' | Añade dotenv a package.json. |
Error: Cannot find module './index.js' | Valor incorrecto en la variable Archivo principal. |
ENOENT: no such file or directory | El archivo indicado no existe. |
Error de token
| Error | Solución |
|---|---|
An invalid token was provided | Revisa el token en .env. |
TOKEN_INVALID | Regenera el token en el Portal de desarrolladores de Discord. |
Used disallowed intents | Activa los intents en el Portal de desarrolladores de Discord. |
El bot no lee los mensajes
| Causa | Solución |
|---|---|
| MESSAGE CONTENT INTENT desactivado | Actívalo en el Portal de desarrolladores de Discord. |
| Intents incorrectos en el código | Añade GatewayIntentBits.MessageContent. |
El archivo .env no se lee
| Causa | Solución |
|---|---|
| Falta dotenv | Comprueba que está en package.json. |
require mal colocado | require('dotenv').config(); debe ser la primera línea. |
| Nombre de archivo incorrecto | El archivo debe llamarse exactamente .env. |
npm install falla
| Error | Solución |
|---|---|
package.json not found | Comprueba que el archivo está en la raíz. |
ERESOLVE unable to resolve | Actualiza las versiones en package.json. |
Buenas prácticas
Proteger el archivo .env
| Haz esto | Evita esto |
|---|---|
Guardar el .env solo en el servidor | Compartir el .env |
Crear el .env directamente en OuiPanel | Subir el .env desde tu ordenador |
Añadir .env al .gitignore | Publicar el .env en GitHub |
Archivo .gitignore recomendado en tu proyecto:
# Variables de entorno
.env
# Módulos de Node
node_modules/
Seguridad y rendimiento
No compartas nunca tu token y regenéralo si se filtra.
Crea el
.envdirectamente en el servidor.Activa solo los intents necesarios.
Gestiona los errores con
try/catchy añade logs para depurar.
Organizar un bot más grande
Para un bot mejor organizado, separa comandos y eventos.
MiBot/
├── index.js ← Punto de entrada
├── package.json
├── .env ← Creado en el servidor
├── comandos/
│ ├── ping.js
│ ├── ayuda.js
│ └── info.js
├── eventos/
│ ├── listo.js
│ └── mensajeCrear.js
└── config.json ← Configuración no sensible
¿Necesitas ayuda?
Abre un ticket desde Tickets › Abrir un ticket, o desde el recuadro Contactar con el soporte al pie de la ficha de tu servidor en el área de cliente. También puedes preguntar en el Discord de OuiHeberg.
Despliega tus aplicaciones Node.js con nuestro alojamiento optimizado y soporte dedicado.
Ver ofertas →