Come ospitare un bot Discord (Python) su OuiPanel
Questa guida spiega come ospitare un bot Discord scritto in Python con discord.py, da bot.py al primo !ping, su un server Python di OuiHeberg gestito in OuiPanel. Il bot gira di continuo sul server, anche quando il tuo computer è spento. Ti servono un bot creato sul Portale sviluppatori di Discord, il suo token, i file del bot (bot.py, requirements.txt…) e un server Python (vedi le offerte per bot Discord).
Creare il bot su Discord
Hai già il tuo bot e il suo token? Passa alla sezione successiva.
Creare l'applicazione
Vai sul Portale sviluppatori di Discord e accedi con il tuo account Discord.
Clicca su New Application.
Dai un nome alla tua applicazione, per esempio «Il mio bot Python», accetta le condizioni d'uso, poi clicca su Create.

Recuperare il token
Il token è la chiave segreta che permette al tuo codice di collegarsi al bot.
Nella sezione Bot, trova la zona TOKEN e clicca su Reset Token.
Conferma con Yes, do it! nella finestra.
Clicca su Copy per copiare il token e conservalo in un posto sicuro per i passaggi successivi.

Il token è come una password. Non condividerlo mai e non metterlo mai in codice pubblico (GitHub, GitLab, ecc.). Se viene compromesso, rigeneralo subito.
Attivare gli intent
Gli intent danno al tuo bot accesso a certe informazioni (messaggi, membri, ecc.). Sempre nella sezione Bot, scorri fino a Privileged Gateway Intents, attiva gli intent che ti servono, poi clicca su Save Changes.
| Intent | Descrizione | Raccomandazione |
|---|---|---|
| PRESENCE INTENT | Vedere lo stato dei membri | Facoltativo |
| SERVER MEMBERS INTENT | Accedere all'elenco dei membri | Facoltativo |
| MESSAGE CONTENT INTENT | Leggere il contenuto dei messaggi | Obbligatorio |

Senza MESSAGE CONTENT INTENT il tuo bot non può leggere il contenuto dei messaggi degli utenti.
Invitare il bot sul tuo server Discord
Nel menu a sinistra, clicca su OAuth2, poi su URL Generator.
In SCOPES, spunta bot (e applications.commands per i comandi slash).
In BOT PERMISSIONS, spunta i permessi necessari (vedi la tabella).
In fondo alla pagina, copia l'URL generato e aprilo nel browser.
Scegli il server dove invitare il bot, clicca su Autorizza e completa il captcha se richiesto.
| Permesso | Descrizione |
|---|---|
| Administrator | Tutti i permessi (semplice ma ampio) |
| Send Messages | Inviare messaggi |
| Read Message History | Leggere la cronologia |
| Embed Links | Inviare embed |
| Attach Files | Inviare file |
| Use Slash Commands | Usare i comandi slash |
Scegli Administrator oppure solo i permessi precisi di cui il tuo bot ha bisogno.

Il tuo bot compare ora nell'elenco dei membri del tuo server Discord, per ora offline.

Preparare i file del bot
Struttura dei file
Il tuo bot deve avere questa struttura.
MonBotPython/
├── bot.py ← File principale (o main.py, index.py...)
├── requirements.txt ← Dipendenze Python
├── .env ← Token del bot (creato sul server)
└── cogs/ ← (Opzionale) Cartella dei moduli
Il file requirements.txt
Crea un file requirements.txt con le dipendenze discord.py e python-dotenv.
audioop-lts==0.2.1; python_version >= "3.13"
discord.py==2.3.2
python-dotenv==1.0.0
Due pacchetti sono essenziali. discord.py è la libreria che comunica con Discord, python-dotenv carica il token dal file .env. La riga audioop-lts sostituisce il modulo audioop, rimosso da Python 3.13. La condizione a fine riga lo installa solo con quella versione.
Il file principale (bot.py)
Crea il tuo file principale. Carica il token con python-dotenv.
import os
import discord
from discord.ext import commands
from dotenv import load_dotenv
# Carica le variabili d'ambiente da .env
load_dotenv()
# Configurazione degli intents
intents = discord.Intents.default()
intents.message_content = True
# Creazione del bot con un prefisso
bot = commands.Bot(command_prefix='!', intents=intents)
# Evento : Bot pronto
@bot.event
async def on_ready():
print(f'Bot connesso come {bot.user.name}')
print(f'Connesso a {len(bot.guilds)} server(s)')
# Comando : !ping
@bot.command()
async def ping(ctx):
"""Risponde Pong con la latenza"""
latenza = round(bot.latency * 1000)
await ctx.send(f'Pong! Latenza: {latenza}ms')
# Comando : !hello
@bot.command()
async def hello(ctx):
"""Dice ciao"""
await ctx.send(f'Ciao {ctx.author.name}!')
# Gestione degli errori
@bot.event
async def on_command_error(ctx, error):
if isinstance(error, commands.CommandNotFound):
await ctx.send('Comando sconosciuto.')
else:
print(f'Errore : {error}')
# Connessione con il token da .env
bot.run(os.getenv('DISCORD_TOKEN'))
load_dotenv()va chiamato prima di usareos.getenv().
Caricare i file su OuiPanel
La Gestione file non ha un pulsante di caricamento. I file si inviano trascinandoli nella pagina.
Accedi a OuiPanel su dash.ouipanel.com e apri il tuo server Python.
Nel menu laterale, clicca su Gestione file.
Elimina i file predefiniti, se ce ne sono.
Dal tuo computer, trascina nella pagina
bot.py,requirements.txte le tue cartelle (cogs/…).Quando compare il riquadro «Trascina i tuoi file qui», rilascia.
Ogni file inviato così è limitato a 100 MB.

Non caricare il tuo file
.env. Lo creerai direttamente sul server nel passaggio successivo, è più sicuro.
Via SFTP
Per molti file, o file oltre i 100 MB, usa l'SFTP. Collegati con FileZilla, trascina tutto il contenuto della cartella del bot, poi verifica che sia arrivato tutto. La guida Come connettersi in SFTP con FileZilla spiega la connessione.
Creare il file .env
Non mettere mai il tuo token direttamente nel codice. Crea un file .env sul server.
Nella Gestione file, nella Radice, clicca su Crea un file.
Nella finestra «Crea un nuovo file», scrivi
.envin Nome del file, con il punto davanti, poi clicca su Crea il file.Clicca su
.envper aprirlo nell'editor e incolla il contenuto qui sotto.Sostituisci
il_tuo_token_quicon il token copiato, poi clicca su Salva.
# Token del bot Discord
DISCORD_TOKEN=il_tuo_token_qui
Esempio con un token reale (formato):
DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
Esempio con più variabili:
# Token del bot Discord
DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
# Prefisso dei comandi
PREFIX=!
# ID del proprietario (opzionale)
OWNER_ID=123456789012345678
Nessuno spazio intorno al
=.Nessuna virgoletta intorno ai valori.
Non condividere mai questo file.

Ecco la struttura finale sul server.
Radice del server/
├── .env ← Contiene DISCORD_TOKEN
├── bot.py ← Il tuo codice
├── requirements.txt ← Dipendenze
└── ...
Scegliere il file di avvio e la versione di Python
OuiPanel deve sapere quale file Python avviare all'accensione. Su un server Python, questa impostazione è una variabile del server.
Apri Configurazione › Impostazioni del server.
Nella scheda Avvio del server, controlla la Versione sistema. L'elenco propone Python 2.7 e tutte le versioni dalla 3.7 alla 3.13, con la 3.13 in versione candidata. È consigliata la 3.12.
Nella scheda Variabili d'ambiente, scrivi il nome del tuo file in File Python di avvio (file di avvio; i nomi delle variabili sono in francese).
Clicca sulla spunta a destra del campo (Salva).
| Il tuo file principale | Valore di File Python di avvio |
|---|---|
bot.py | bot.py |
main.py | main.py |
index.py | index.py |
app.py | app.py |
src/bot.py | src/bot.py |
La stessa scheda indica in File delle dipendenze il file dei requisiti da installare (requirements.txt di default). Pacchetti Python aggiuntivi installa altri pacchetti, separati da spazi.

Il nome deve corrispondere esattamente al tuo file, maiuscole comprese.
Avviare e provare il bot
Avviare il server
Nel menu laterale, clicca su Console, poi su Avvia. All'avvio il server installa i pacchetti di requirements.txt, poi esegue il tuo file.
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 connesso come MonBot
Connesso a 1 server(s)
Verificare su Discord
La console deve mostrare queste righe.
Bot connesso come MonBot
Connesso a 1 server(s)
Apri Discord e vai sul server dove hai invitato il bot.
Il tuo bot appare online, con un pallino verde.
Prova il comando
!ping. Il bot risponde «Pong! Latenza: XXms».
Distribuire da un repository Git
Il tuo codice è su GitHub, GitLab, Bitbucket o Codeberg? La pagina Distribuzione scarica il repository e installa i pacchetti di requirements.txt al posto tuo, senza caricare i file a mano.
Nel menu laterale, clicca su Distribuzione.
Nel blocco Collegare un repository, compila Indirizzo del repository e Ramo.
In Accesso al repository, scegli Repository pubblico oppure una delle due opzioni per repository privati (chiave di distribuzione o token di accesso).
Spunta Distribuire a ogni push sul ramo se vuoi aggiornamenti automatici, poi clicca su Salva.
Clicca su Distribuisci ora.
Ogni distribuzione riavvia il server, che resta fermo mentre vengono installate le dipendenze. Se l'installazione non riesce, riparte la versione precedente. I file non tracciati da Git, come il tuo .env, restano al loro posto. Prima della prima distribuzione, il pannello fa un backup del server.

Per un repository privato è consigliata la chiave di distribuzione. Il pannello genera una chiave propria del server, da aggiungere al repository in sola lettura.
Avviare più bot con una sola offerta
Un server Python avvia un solo file all'accensione. Per far girare più bot con la stessa offerta, quel file può essere uno script di avvio che lancia ogni bot in un processo separato. Se un bot va in crash, gli altri continuano a funzionare. Tutti condividono la memoria e il processore dell'offerta.
Carica i file dei tuoi bot nella radice del server, per esempio
bot1.pyebot2.py.Riunisci i pacchetti di tutti i bot nel
requirements.txtdella radice.Nel file
.env, dai un nome diverso al token di ogni bot, comeDISCORD_TOKEN_1eDISCORD_TOKEN_2. Fai leggere a ogni bot il suo, per esempio conbot.run(os.getenv('DISCORD_TOKEN_1')).Nella radice, crea un file
launcher.pycon il contenuto qui sotto, poi adatta l'elencoBOTS.In Configurazione › Impostazioni del server, scrivi
launcher.pyin Fichier py de démarrage (file di avvio), poi clicca sulla spunta (Salva).Nella Console, clicca su Riavvia.
# Avvia ogni bot in un processo separato
import subprocess
import sys
import threading
# I file dei tuoi bot, nella radice del server
BOTS = ["bot1.py", "bot2.py"]
def run(file):
process = subprocess.Popen(
[sys.executable, "-u", file],
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
text=True,
)
# Mostra ogni riga del bot nella console, preceduta dal suo nome
for line in process.stdout:
print(f"[{file}] {line}", end="", flush=True)
print(f"[{file}] arrestato (codice {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()
Nella console, ogni riga inizia con il nome del bot che la scrive, per esempio [bot1.py] Bot connesso come MonBot. Quando un bot si ferma, lo script di avvio mostra il suo codice di uscita.
Lo script di avvio non riavvia un bot che si ferma. Per rilanciarlo, riavvia il server.
Risolvere un problema
Il bot non si avvia
| Errore | Soluzione |
|---|---|
ModuleNotFoundError: No module named 'discord' | Controlla requirements.txt e riavvia. |
ModuleNotFoundError: No module named 'dotenv' | Aggiungi python-dotenv in requirements.txt. |
FileNotFoundError: bot.py | Valore sbagliato nella variabile File Python di avvio. |
SyntaxError | Errore nel tuo codice Python. |
Errore di token
| Errore | Soluzione |
|---|---|
LoginFailure: Improper token has been passed | Controlla il token in .env. |
HTTPException: 401 Unauthorized | Token non valido, rigeneralo. |
PrivilegedIntentsRequired | Attiva gli intent sul Portale sviluppatori di Discord. |
Il bot non legge i messaggi
| Causa | Soluzione |
|---|---|
| MESSAGE CONTENT INTENT disattivato | Attivalo sul Portale sviluppatori di Discord. |
| Intent configurati male nel codice | Aggiungi intents.message_content = True. |
Controlla il tuo codice:
intents = discord.Intents.default()
intents.message_content = True # Questa riga è obbligatoria!
Il file .env non viene letto
| Causa | Soluzione |
|---|---|
| python-dotenv mancante | Controlla requirements.txt. |
load_dotenv() non chiamato | Aggiungi load_dotenv() prima di os.getenv(). |
| Nome del file sbagliato | Il file deve chiamarsi esattamente .env. |
| Formato sbagliato | Nessuno spazio intorno al =. |
pip install non riesce
| Errore | Soluzione |
|---|---|
requirements.txt not found | Verifica che il file sia nella radice. |
Could not find a version | Controlla nomi e versioni dei pacchetti, e la versione di Python scelta. |
Buone pratiche
Proteggere il file .env
| Da fare | Da evitare |
|---|---|
Tenere il .env solo sul server | Condividere il .env |
Creare il .env direttamente in OuiPanel | Mettere il token nel codice |
Aggiungere .env al .gitignore | Pubblicare il .env su GitHub |
File .gitignore consigliato nel tuo progetto:
# Variabili d'ambiente
.env
.env.local
# Python
__pycache__/
*.py[cod]
venv/
Sicurezza, prestazioni e codice
Non condividere mai il tuo token, crea il
.envdirettamente sul server e rigenera il token se trapela.Attiva solo gli intent necessari.
Usa
commands.Botinvece didiscord.Clientper i comandi.Gestisci gli errori con
try/excepte aggiungi log conprint()o il modulologging.Dividi i bot grandi in Cog.
Organizzare il bot in Cog
Per un bot più ordinato, distribuisci i comandi in Cog.
MonBotPython/
├── bot.py ← Punto d'ingresso
├── requirements.txt
├── .env ← Creato sul server
├── cogs/
│ ├── moderation.py ← Comandi di moderazione
│ ├── fun.py ← Comandi divertenti
│ └── utility.py ← Comandi utilitari
└── config.py ← Configurazione non sensibile
Esempio di bot.py con i Cog:
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)
# Carica i cogs all'avvio
@bot.event
async def on_ready():
print(f'Bot connesso come {bot.user.name}')
# Carica i cogs
for filename in os.listdir('./cogs'):
if filename.endswith('.py'):
await bot.load_extension(f'cogs.{filename[:-3]}')
print(f'Cog caricato : {filename}')
bot.run(os.getenv('DISCORD_TOKEN'))
Esempio di 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):
"""Risponde Pong !"""
latenza = round(self.bot.latency * 1000)
await ctx.send(f'Pong! Latenza: {latenza}ms')
@commands.command()
async def hello(self, ctx):
"""Dice ciao"""
await ctx.send(f'Ciao {ctx.author.name}!')
async def setup(bot):
await bot.add_cog(Fun(bot))
Hai bisogno di aiuto?
Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.
Distribuisci le tue applicazioni Python con il nostro hosting ottimizzato e supporto dedicato.
Vedi le offerte →