PythonPubblicato il 15 dicembre 2025Lettura di 11 min

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

  1. Vai sul Portale sviluppatori di Discord e accedi con il tuo account Discord.

  2. Clicca su New Application.

  3. Dai un nome alla tua applicazione, per esempio «Il mio bot Python», accetta le condizioni d'uso, poi clicca su Create.

Finestra Create an application del Portale sviluppatori di Discord con il nome del bot

Recuperare il token

Il token è la chiave segreta che permette al tuo codice di collegarsi al bot.

  1. Nella sezione Bot, trova la zona TOKEN e clicca su Reset Token.

  2. Conferma con Yes, do it! nella finestra.

  3. Clicca su Copy per copiare il token e conservalo in un posto sicuro per i passaggi successivi.

Sezione Bot del Portale sviluppatori di Discord con il pulsante Reset Token

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.

IntentDescrizioneRaccomandazione
PRESENCE INTENTVedere lo stato dei membriFacoltativo
SERVER MEMBERS INTENTAccedere all'elenco dei membriFacoltativo
MESSAGE CONTENT INTENTLeggere il contenuto dei messaggiObbligatorio

Sezione Privileged Gateway Intents del Portale sviluppatori di Discord con i tre interruttori

Senza MESSAGE CONTENT INTENT il tuo bot non può leggere il contenuto dei messaggi degli utenti.

Invitare il bot sul tuo server Discord

  1. Nel menu a sinistra, clicca su OAuth2, poi su URL Generator.

  2. In SCOPES, spunta bot (e applications.commands per i comandi slash).

  3. In BOT PERMISSIONS, spunta i permessi necessari (vedi la tabella).

  4. In fondo alla pagina, copia l'URL generato e aprilo nel browser.

  5. Scegli il server dove invitare il bot, clicca su Autorizza e completa il captcha se richiesto.

PermessoDescrizione
AdministratorTutti i permessi (semplice ma ampio)
Send MessagesInviare messaggi
Read Message HistoryLeggere la cronologia
Embed LinksInviare embed
Attach FilesInviare file
Use Slash CommandsUsare i comandi slash

Scegli Administrator oppure solo i permessi precisi di cui il tuo bot ha bisogno.

Elenco Bot Permissions dello URL Generator con la casella Administrator spuntata

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

Finestra di Discord per autorizzare il bot con la scelta del server


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 usare os.getenv().


Caricare i file su OuiPanel

La Gestione file non ha un pulsante di caricamento. I file si inviano trascinandoli nella pagina.

  1. Accedi a OuiPanel su dash.ouipanel.com e apri il tuo server Python.

  2. Nel menu laterale, clicca su Gestione file.

  3. Elimina i file predefiniti, se ce ne sono.

  4. Dal tuo computer, trascina nella pagina bot.py, requirements.txt e le tue cartelle (cogs/…).

  5. Quando compare il riquadro «Trascina i tuoi file qui», rilascia.

Ogni file inviato così è limitato a 100 MB.

Riquadro Trascina i tuoi file qui mostrato durante il trascinamento nella Gestione file

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.

  1. Nella Gestione file, nella Radice, clicca su Crea un file.

  2. Nella finestra «Crea un nuovo file», scrivi .env in Nome del file, con il punto davanti, poi clicca su Crea il file.

  3. Clicca su .env per aprirlo nell'editor e incolla il contenuto qui sotto.

  4. Sostituisci il_tuo_token_qui con 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.

Gestione file nella radice di un bot Python con bot.py, requirements.txt e la cartella cogs

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.

  1. Apri Configurazione › Impostazioni del server.

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

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

  4. Clicca sulla spunta a destra del campo (Salva).

Il tuo file principaleValore di File Python di avvio
bot.pybot.py
main.pymain.py
index.pyindex.py
app.pyapp.py
src/bot.pysrc/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.

Variabili d'ambiente di un server Python con File Python di avvio e File delle dipendenze

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)
  1. Apri Discord e vai sul server dove hai invitato il bot.

  2. Il tuo bot appare online, con un pallino verde.

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

  1. Nel menu laterale, clicca su Distribuzione.

  2. Nel blocco Collegare un repository, compila Indirizzo del repository e Ramo.

  3. In Accesso al repository, scegli Repository pubblico oppure una delle due opzioni per repository privati (chiave di distribuzione o token di accesso).

  4. Spunta Distribuire a ogni push sul ramo se vuoi aggiornamenti automatici, poi clicca su Salva.

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

Pagina Distribuzione Git con Collegare un repository, Indirizzo del repository, Ramo e Accesso al repository

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.

  1. Carica i file dei tuoi bot nella radice del server, per esempio bot1.py e bot2.py.

  2. Riunisci i pacchetti di tutti i bot nel requirements.txt della radice.

  3. Nel file .env, dai un nome diverso al token di ogni bot, come DISCORD_TOKEN_1 e DISCORD_TOKEN_2. Fai leggere a ogni bot il suo, per esempio con bot.run(os.getenv('DISCORD_TOKEN_1')).

  4. Nella radice, crea un file launcher.py con il contenuto qui sotto, poi adatta l'elenco BOTS.

  5. In Configurazione › Impostazioni del server, scrivi launcher.py in Fichier py de démarrage (file di avvio), poi clicca sulla spunta (Salva).

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

ErroreSoluzione
ModuleNotFoundError: No module named 'discord'Controlla requirements.txt e riavvia.
ModuleNotFoundError: No module named 'dotenv'Aggiungi python-dotenv in requirements.txt.
FileNotFoundError: bot.pyValore sbagliato nella variabile File Python di avvio.
SyntaxErrorErrore nel tuo codice Python.

Errore di token

ErroreSoluzione
LoginFailure: Improper token has been passedControlla il token in .env.
HTTPException: 401 UnauthorizedToken non valido, rigeneralo.
PrivilegedIntentsRequiredAttiva gli intent sul Portale sviluppatori di Discord.

Il bot non legge i messaggi

CausaSoluzione
MESSAGE CONTENT INTENT disattivatoAttivalo sul Portale sviluppatori di Discord.
Intent configurati male nel codiceAggiungi 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

CausaSoluzione
python-dotenv mancanteControlla requirements.txt.
load_dotenv() non chiamatoAggiungi load_dotenv() prima di os.getenv().
Nome del file sbagliatoIl file deve chiamarsi esattamente .env.
Formato sbagliatoNessuno spazio intorno al =.

pip install non riesce

ErroreSoluzione
requirements.txt not foundVerifica che il file sia nella radice.
Could not find a versionControlla nomi e versioni dei pacchetti, e la versione di Python scelta.

Buone pratiche

Proteggere il file .env

Da fareDa evitare
Tenere il .env solo sul serverCondividere il .env
Creare il .env direttamente in OuiPanelMettere il token nel codice
Aggiungere .env al .gitignorePubblicare 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 .env direttamente sul server e rigenera il token se trapela.

  • Attiva solo gli intent necessari.

  • Usa commands.Bot invece di discord.Client per i comandi.

  • Gestisci gli errori con try/except e aggiungi log con print() o il modulo logging.

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

Questo articolo ti è stato utile?

463 visualizzazioni
Condividi questo articolo
Python
Hai bisogno di un hosting Python?

Distribuisci le tue applicazioni Python con il nostro hosting ottimizzato e supporto dedicato.

Vedi le offerte →

Articoli correlati