NodeJSPublicado el 15 de diciembre de 2025Lectura de 9 min

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

  1. Ve al Portal de desarrolladores de Discord e inicia sesión con tu cuenta de Discord.

  2. Haz clic en New Application.

  3. Pon un nombre a tu aplicación, por ejemplo «Mi Bot», acepta las condiciones y haz clic en Create.

Ventana Create an application del Portal de desarrolladores de Discord con el campo Name

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

  1. En la sección Bot, haz clic en Reset Token.

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

IntentUso
PRESENCE INTENTOpcional
SERVER MEMBERS INTENTOpcional
MESSAGE CONTENT INTENTObligatorio para leer el contenido de los mensajes

Sección Privileged Gateway Intents del Portal de desarrolladores de Discord con sus tres interruptores

Sin MESSAGE CONTENT INTENT, tu bot no puede leer el contenido de los mensajes, y un comando como !ping se queda sin respuesta.

Invitar el bot a tu servidor de Discord

  1. En el menú de la izquierda, haz clic en OAuth2 › URL Generator.

  2. En Scopes, marca bot y applications.commands.

  3. En Bot Permissions, marca los permisos necesarios, o Administrator para todos.

  4. Copia la URL generada al pie de la página, ábrela e invita el bot a tu servidor de Discord.

Campo Generated URL de la página OAuth2 con el enlace de invitación del bot


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.

  1. Inicia sesión en OuiPanel en dash.ouipanel.com y abre tu servidor Node.js.

  2. En el menú lateral, haz clic en Gestor de archivos.

  3. Borra los archivos por defecto, si los hay.

  4. Desde tu ordenador, arrastra a la página index.js, package.json y tus carpetas (commands/, events/…).

  5. Cuando aparezca la capa «Arrastra tus archivos aquí», suelta.

Cada archivo enviado así está limitado a 100 MB.

Capa Arrastra tus archivos aquí mostrada al arrastrar archivos en el Gestor de archivos

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.

  1. En el Gestor de archivos, en la Raíz, haz clic en Crear un archivo.

  2. En la ventana «Crear un nuevo archivo», escribe .env en Nombre del archivo, con el punto delante, y haz clic en Crear el archivo.

  3. Haz clic en .env para abrirlo en el editor y pega el contenido de abajo.

  4. Cambia tu_token_aqui por 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.

Gestor de archivos en la raíz de un servidor Node.js con index.js, package.json y package-lock.json

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.

  1. Abre Configuración › Parámetros del servidor.

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

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

  4. Haz clic en la marca a la derecha del campo (Guardar).

Tu archivo principalValor de Archivo principal
index.jsindex.js
bot.jsbot.js
main.jsmain.js
src/index.jssrc/index.js
app.jsapp.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.

Parámetros de un servidor Node.js con la versión Nodejs 24 y la variable Archivo principal

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
  1. Abre Discord. Tu bot aparece en línea, con un punto verde.

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

  1. En el menú lateral, haz clic en Despliegue.

  2. En el bloque Vincular un repositorio, rellena Dirección del repositorio y Rama.

  3. En Acceso al repositorio, elige Repositorio público o una de las dos opciones de repositorio privado (clave de despliegue o token de acceso).

  4. Marca Desplegar en cada push a la rama si quieres actualizaciones automáticas y haz clic en Guardar.

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

Página Despliegue Git con Vincular un repositorio, Dirección del repositorio, Rama y Acceso al repositorio

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.

  1. Sube los archivos de tus bots a la raíz del servidor, por ejemplo bot1.js y bot2.js.

  2. Reúne las dependencias de todos los bots en el package.json de la raíz.

  3. En el archivo .env, da un nombre distinto al token de cada bot, como DISCORD_TOKEN_1 y DISCORD_TOKEN_2. Haz que cada bot lea el suyo, por ejemplo con client.login(process.env.DISCORD_TOKEN_1).

  4. En la raíz, crea un archivo launcher.js con el contenido de abajo y adapta la lista bots.

  5. En Configuración › Parámetros del servidor, escribe launcher.js en Fichier principal (archivo principal) y haz clic en la marca (Guardar).

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

ErrorSolució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 directoryEl archivo indicado no existe.

Error de token

ErrorSolución
An invalid token was providedRevisa el token en .env.
TOKEN_INVALIDRegenera el token en el Portal de desarrolladores de Discord.
Used disallowed intentsActiva los intents en el Portal de desarrolladores de Discord.

El bot no lee los mensajes

CausaSolución
MESSAGE CONTENT INTENT desactivadoActívalo en el Portal de desarrolladores de Discord.
Intents incorrectos en el códigoAñade GatewayIntentBits.MessageContent.

El archivo .env no se lee

CausaSolución
Falta dotenvComprueba que está en package.json.
require mal colocadorequire('dotenv').config(); debe ser la primera línea.
Nombre de archivo incorrectoEl archivo debe llamarse exactamente .env.

npm install falla

ErrorSolución
package.json not foundComprueba que el archivo está en la raíz.
ERESOLVE unable to resolveActualiza las versiones en package.json.

Buenas prácticas

Proteger el archivo .env

Haz estoEvita esto
Guardar el .env solo en el servidorCompartir el .env
Crear el .env directamente en OuiPanelSubir el .env desde tu ordenador
Añadir .env al .gitignorePublicar 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 .env directamente en el servidor.

  • Activa solo los intents necesarios.

  • Gestiona los errores con try/catch y 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.

¿Te ha sido útil este artículo?

421 vistas
Compartir este artículo
Node.js
¿Necesitas alojamiento Node.js?

Despliega tus aplicaciones Node.js con nuestro alojamiento optimizado y soporte dedicado.

Ver ofertas →

Artículos relacionados

¿No encontraste lo que buscabas?

El equipo de soporte responde 7 días a la semana.

Abrir un ticketDesde tu área de clienteDiscord de la comunidadAyuda y anunciosEstado de los serviciosstatus.ouiheberg.com