PythonPublicado el 15 de diciembre de 2025Lectura de 11 min

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

  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 Python», acepta las condiciones de uso y haz clic en Create.

Ventana Create an application del Portal de desarrolladores de Discord con el nombre del bot

Obtener el token

El token es la clave secreta que permite a tu código conectarse al bot.

  1. En la sección Bot, busca la zona TOKEN y haz clic en Reset Token.

  2. Confirma con Yes, do it! en la ventana.

  3. Haz clic en Copy para copiar el token y guárdalo en un lugar seguro para los pasos siguientes.

Sección Bot del Portal de desarrolladores de Discord con el botón Reset Token

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.

IntentDescripciónRecomendación
PRESENCE INTENTVer el estado de los miembrosOpcional
SERVER MEMBERS INTENTAcceder a la lista de miembrosOpcional
MESSAGE CONTENT INTENTLeer el contenido de los mensajesObligatorio

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 de los usuarios.

Invitar el bot a tu servidor de Discord

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

  2. En SCOPES, marca bot (y applications.commands para los comandos slash).

  3. En BOT PERMISSIONS, marca los permisos necesarios (mira la tabla).

  4. Al pie de la página, copia la URL generada y ábrela en tu navegador.

  5. Elige el servidor al que invitar el bot, haz clic en Autorizar y completa el captcha si te lo pide.

PermisoDescripción
AdministratorTodos los permisos (sencillo pero amplio)
Send MessagesEnviar mensajes
Read Message HistoryLeer el historial
Embed LinksEnviar embeds
Attach FilesEnviar archivos
Use Slash CommandsUsar los comandos slash

Elige Administrator o solo los permisos concretos que necesita tu bot.

Lista Bot Permissions del URL Generator con la casilla Administrator marcada

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

Ventana de Discord para autorizar el bot con la elección del servidor


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 usar os.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.

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

  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 bot.py, requirements.txt y tus carpetas (cogs/…).

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

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

Gestor de archivos en la raíz de un bot de Python con bot.py, requirements.txt y la carpeta cogs

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.

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

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

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

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

Tu archivo principalValor de Archivo Python de inicio
bot.pybot.py
main.pymain.py
index.pyindex.py
app.pyapp.py
src/bot.pysrc/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.

Variables de entorno de un servidor Python con Archivo Python de inicio y Archivo de dependencias

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)
  1. Abre Discord y ve al servidor donde invitaste el bot.

  2. Tu bot aparece en línea, con un punto verde.

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

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

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

  2. Reúne los paquetes de todos los bots en el requirements.txt 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 bot.run(os.getenv('DISCORD_TOKEN_1')).

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

  5. En Configuración › Parámetros del servidor, escribe launcher.py en Fichier py de démarrage (archivo de inicio) y haz clic en la marca (Guardar).

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

ErrorSolució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.pyValor incorrecto en la variable Archivo Python de inicio.
SyntaxErrorError en tu código Python.

Error de token

ErrorSolución
LoginFailure: Improper token has been passedRevisa el token en .env.
HTTPException: 401 UnauthorizedToken no válido, regenéralo.
PrivilegedIntentsRequiredActiva 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 mal configurados en el códigoAñ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

CausaSolución
Falta python-dotenvRevisa requirements.txt.
No se llama a load_dotenv()Añade load_dotenv() antes de os.getenv().
Nombre de archivo incorrectoEl archivo debe llamarse exactamente .env.
Formato incorrectoSin espacios alrededor del =.

pip install falla

ErrorSolución
requirements.txt not foundComprueba que el archivo está en la raíz.
Could not find a versionRevisa los nombres y versiones de los paquetes, y la versión de Python elegida.

Buenas prácticas

Proteger el archivo .env

Haz estoEvita esto
Guardar el .env solo en el servidorCompartir el .env
Crear el .env directamente en OuiPanelPoner el token en el código
Añadir .env al .gitignorePublicar 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 .env directamente en el servidor y regenera el token si se filtra.

  • Activa solo los intents necesarios.

  • Usa commands.Bot en lugar de discord.Client para los comandos.

  • Gestiona los errores con try/except y añade logs con print() o el módulo logging.

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

¿Te ha sido útil este artículo?

463 vistas
Compartir este artículo
Python
¿Necesitas alojamiento Python?

Despliega tus aplicaciones Python 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