Cómo alojar un bot de Discord (Python) en OuiPanel
Esta guía te explica cómo alojar un bot de Discord escrito en Python con discord.py, desde python bot.py hasta el primer !ping, en un servidor Python 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, los archivos del bot (bot.py, requirements.txt…) y un servidor Python (consulta los planes para bots de Discord).
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 Python», acepta las condiciones de uso y haz clic en Create.

Obtener el token
El token es la clave secreta que permite a tu código conectarse al bot.
En la sección Bot, busca la zona TOKEN y haz clic en Reset Token.
Confirma con Yes, do it! en la ventana.
Haz clic en Copy para copiar el token y guárdalo en un lugar seguro para los pasos siguientes.

El token es como una contraseña. No lo compartas nunca ni lo pongas en código público (GitHub, GitLab, etc.). Si se filtra, regenéralo enseguida.
Activar los intents
Los intents dan a tu bot acceso a cierta información (mensajes, miembros, etc.). En la misma sección Bot, baja hasta Privileged Gateway Intents, activa los intents que necesites y haz clic en Save Changes.
| Intent | Descripción | Recomendación |
|---|---|---|
| PRESENCE INTENT | Ver el estado de los miembros | Opcional |
| SERVER MEMBERS INTENT | Acceder a la lista de miembros | Opcional |
| MESSAGE CONTENT INTENT | Leer el contenido de los mensajes | Obligatorio |

Sin MESSAGE CONTENT INTENT, tu bot no puede leer el contenido de los mensajes de los usuarios.
Invitar el bot a tu servidor de Discord
En el menú de la izquierda, haz clic en OAuth2 y luego en URL Generator.
En SCOPES, marca bot (y applications.commands para los comandos slash).
En BOT PERMISSIONS, marca los permisos necesarios (mira la tabla).
Al pie de la página, copia la URL generada y ábrela en tu navegador.
Elige el servidor al que invitar el bot, haz clic en Autorizar y completa el captcha si te lo pide.
| Permiso | Descripción |
|---|---|
| Administrator | Todos los permisos (sencillo pero amplio) |
| Send Messages | Enviar mensajes |
| Read Message History | Leer el historial |
| Embed Links | Enviar embeds |
| Attach Files | Enviar archivos |
| Use Slash Commands | Usar los comandos slash |
Elige Administrator o solo los permisos concretos que necesita tu bot.

Tu bot aparece ahora en la lista de miembros de tu servidor de Discord, desconectado por el momento.

Preparar los archivos del bot
Estructura de archivos
Tu bot debe tener esta estructura.
MiBotPython/
├── bot.py ← Archivo principal (o main.py, index.py...)
├── requirements.txt ← Dependencias Python
├── .env ← Token del bot (creado en el servidor)
└── cogs/ ← (Opcional) Carpeta de módulos
El archivo requirements.txt
Crea un archivo requirements.txt con las dependencias discord.py y python-dotenv.
audioop-lts==0.2.1; python_version >= "3.13"
discord.py==2.3.2
python-dotenv==1.0.0
Dos paquetes son esenciales. discord.py es la biblioteca que se comunica con Discord, python-dotenv carga el token desde el archivo .env. La línea audioop-lts sustituye al módulo audioop, eliminado en Python 3.13. La condición al final de la línea solo lo instala con esa versión.
El archivo principal (bot.py)
Crea tu archivo principal. Carga el token con python-dotenv.
import os
import discord
from discord.ext import commands
from dotenv import load_dotenv
# Load environment variables from .env
load_dotenv()
# Intents configuration
intents = discord.Intents.default()
intents.message_content = True
# Bot creation with a prefix
bot = commands.Bot(command_prefix='!', intents=intents)
# Event: Bot ready
@bot.event
async def on_ready():
print(f'Bot connected as {bot.user.name}')
print(f'Connected to {len(bot.guilds)} server(s)')
# Command: !ping
@bot.command()
async def ping(ctx):
"""Responds Pong with latency"""
latency = round(bot.latency * 1000)
await ctx.send(f'Pong! Latency: {latency}ms')
# Command: !hello
@bot.command()
async def hello(ctx):
"""Says hello"""
await ctx.send(f'Hello {ctx.author.name}!')
# Error handling
@bot.event
async def on_command_error(ctx, error):
if isinstance(error, commands.CommandNotFound):
await ctx.send('Unknown command.')
else:
print(f'Error: {error}')
# Connect with the token from .env
bot.run(os.getenv('DISCORD_TOKEN'))
load_dotenv()debe llamarse antes de usaros.getenv().
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 Python.
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
bot.py,requirements.txty tus carpetas (cogs/…).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, es más seguro.
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 el token que copiaste y haz clic en Guardar.
# Discord bot token
DISCORD_TOKEN=tu_token_aqui
Ejemplo con un token real (formato):
DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
Ejemplo con varias variables:
# Discord bot token
DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
# Command prefix
PREFIX=!
# Owner ID (optional)
OWNER_ID=123456789012345678
Sin espacios alrededor del
=.Sin comillas alrededor de los valores.
No compartas nunca este archivo.

Esta es la estructura final en el servidor.
Root of the server/
├── .env ← Contains DISCORD_TOKEN
├── bot.py ← Your code
├── requirements.txt ← Dependencies
└── ...
Elegir el archivo de inicio y la versión de Python
OuiPanel tiene que saber qué archivo Python lanzar al arrancar. En un servidor Python, 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 Python 2.7 y todas las versiones de la 3.7 a la 3.13, siendo la 3.13 una versión candidata. Se recomienda la 3.12.
En la tarjeta Variables de entorno, escribe el nombre de tu archivo en Archivo Python de inicio (archivo de inicio; 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 Python de inicio |
|---|---|
bot.py | bot.py |
main.py | main.py |
index.py | index.py |
app.py | app.py |
src/bot.py | src/bot.py |
La misma tarjeta indica en Archivo de dependencias el archivo de requisitos que se instala (requirements.txt por defecto). Paquetes de Python adicionales instala otros paquetes, separados por espacios.

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 los paquetes de requirements.txt y después lanza tu archivo, como si ejecutaras python bot.py.
Installing requirements from requirements.txt...
Collecting discord.py==2.3.2
Collecting python-dotenv==1.0.0
Successfully installed discord.py-2.3.2 python-dotenv-1.0.0
Running bot.py...
Bot connected as MyBot
Connected to 1 server(s)
Comprobar en Discord
La consola debe mostrar estas líneas.
Bot connected as MyBot
Connected to 1 server(s)
Abre Discord y ve al servidor donde invitaste el bot.
Tu bot aparece en línea, con un punto verde.
Prueba el comando
!ping. El bot responde «Pong! Latency: XXms».
Desplegar desde un repositorio Git
¿Tu código está en GitHub, GitLab, Bitbucket o Codeberg? La página Despliegue descarga el repositorio e instala los paquetes de requirements.txt 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 Python 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.pyybot2.py.Reúne los paquetes de todos los bots en el
requirements.txtde 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 conbot.run(os.getenv('DISCORD_TOKEN_1')).En la raíz, crea un archivo
launcher.pycon el contenido de abajo y adapta la listaBOTS.En Configuración › Parámetros del servidor, escribe
launcher.pyen Fichier py de démarrage (archivo de inicio) y haz clic en la marca (Guardar).En la Consola, haz clic en Reiniciar.
# Lanza cada bot en su propio proceso
import subprocess
import sys
import threading
# Los archivos de tus bots, en la raíz del servidor
BOTS = ["bot1.py", "bot2.py"]
def run(file):
process = subprocess.Popen(
[sys.executable, "-u", file],
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
text=True,
)
# Muestra cada línea del bot en la consola, precedida de su nombre
for line in process.stdout:
print(f"[{file}] {line}", end="", flush=True)
print(f"[{file}] detenido (código {process.wait()})", flush=True)
threads = [threading.Thread(target=run, args=(file,)) for file in BOTS]
for thread in threads:
thread.start()
for thread in threads:
thread.join()
En la consola, cada línea empieza por el nombre del bot que la escribe, por ejemplo [bot1.py] Bot connected as MyBot. 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 |
|---|---|
ModuleNotFoundError: No module named 'discord' | Revisa requirements.txt y reinicia. |
ModuleNotFoundError: No module named 'dotenv' | Añade python-dotenv a requirements.txt. |
FileNotFoundError: bot.py | Valor incorrecto en la variable Archivo Python de inicio. |
SyntaxError | Error en tu código Python. |
Error de token
| Error | Solución |
|---|---|
LoginFailure: Improper token has been passed | Revisa el token en .env. |
HTTPException: 401 Unauthorized | Token no válido, regenéralo. |
PrivilegedIntentsRequired | 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 mal configurados en el código | Añade intents.message_content = True. |
Revisa tu código:
intents = discord.Intents.default()
intents.message_content = True # ¡Esta línea es obligatoria!
El archivo .env no se lee
| Causa | Solución |
|---|---|
| Falta python-dotenv | Revisa requirements.txt. |
No se llama a load_dotenv() | Añade load_dotenv() antes de os.getenv(). |
| Nombre de archivo incorrecto | El archivo debe llamarse exactamente .env. |
| Formato incorrecto | Sin espacios alrededor del =. |
pip install falla
| Error | Solución |
|---|---|
requirements.txt not found | Comprueba que el archivo está en la raíz. |
Could not find a version | Revisa los nombres y versiones de los paquetes, y la versión de Python elegida. |
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 | Poner el token en el código |
Añadir .env al .gitignore | Publicar el .env en GitHub |
Archivo .gitignore recomendado en tu proyecto:
# Variables de entorno
.env
.env.local
# Python
__pycache__/
*.py[cod]
venv/
Seguridad, rendimiento y código
No compartas nunca tu token, crea el
.envdirectamente en el servidor y regenera el token si se filtra.Activa solo los intents necesarios.
Usa
commands.Boten lugar dediscord.Clientpara los comandos.Gestiona los errores con
try/excepty añade logs conprint()o el módulologging.Divide los bots grandes en Cogs.
Organizar el bot con Cogs
Para un bot mejor organizado, reparte los comandos en Cogs.
MonBotPython/
├── bot.py ← Punto de entrada
├── requirements.txt
├── .env ← Creado en el servidor
├── cogs/
│ ├── moderation.py ← Comandos de moderación
│ ├── fun.py ← Comandos divertidos
│ └── utility.py ← Comandos de utilidad
└── config.py ← Configuración no sensible
Ejemplo de bot.py con Cogs:
import os
import discord
from discord.ext import commands
from dotenv import load_dotenv
load_dotenv()
intents = discord.Intents.default()
intents.message_content = True
bot = commands.Bot(command_prefix='!', intents=intents)
# Cargar los cogs al inicio
@bot.event
async def on_ready():
print(f'Bot conectado como {bot.user.name}')
# Cargar los cogs
for filename in os.listdir('./cogs'):
if filename.endswith('.py'):
await bot.load_extension(f'cogs.{filename[:-3]}')
print(f'Cog cargado : {filename}')
bot.run(os.getenv('DISCORD_TOKEN'))
Ejemplo de cog (cogs/fun.py):
import discord
from discord.ext import commands
class Fun(commands.Cog):
def __init__(self, bot):
self.bot = bot
@commands.command()
async def ping(self, ctx):
"""Responde Pong !"""
latencia = round(self.bot.latency * 1000)
await ctx.send(f'Pong ! Latencia : {latencia}ms')
@commands.command()
async def hello(self, ctx):
"""Dice hola"""
await ctx.send(f'Hola {ctx.author.name} !')
async def setup(bot):
await bot.add_cog(Fun(bot))
¿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 Python con nuestro alojamiento optimizado y soporte dedicado.
Ver ofertas →