Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Al 10 ottobre 2026, PyPI elenca Simple-Matrix-Bot-Lib 2.13.1, rilasciato il 29 marzo 2026. Il pacchetto richiede Python 3.9 o versioni successive, ma Python 3.9 ha raggiunto la fine del ciclo di vita; utilizzare una versione di Python supportata dal pacchetto. La documentazione del progetto ospitato si riferisce ancora alla versione 2.11.0 e avverte che non è più supportata, quindi questa guida segue l'esempio corrente di PyPI per l'API del bot e utilizza il manuale precedente solo per le note di configurazione chiaramente etichettate. Verificare la versione del pacchetto e i metadati su PyPI . Leggere lo stato della documentazione del progetto .

La configurazione più rapida e affidabile prevede un utente Matrix dedicato, un ambiente virtuale Python e un piccolo bot di tipo "echo" che risponde ai comandi !echoin una stanza di prova. L'esempio si riferisce a una stanza non crittografata; le stanze crittografate richiedono una configurazione aggiuntiva.

Di cosa hai bisogno prima di installare la libreria?

Crea o richiedi un account normale sul server domestico che eseguirà il bot. Assegna un nome utente univoco, ad esempio echo_bot; non necessita di privilegi di amministratore del server domestico. La registrazione potrebbe essere disabilitata o limitata da quel server, quindi segui le sue politiche di creazione account. Invita l'account solo in una stanza di prova privata dove è autorizzato a inviare messaggi.

Utilizza Python 3.11 o un'altra versione di Python attualmente supportata. Sebbene i metadati del pacchetto consentano ancora l'utilizzo di Python 3.9, Python.org indica la fine del ciclo di vita di tale versione a partire dal 31 ottobre 2025, pertanto il requisito minimo del pacchetto non è una buona raccomandazione per l'installazione. Consulta l'avviso di supporto per Python 3.9 su Python.org .

Come si installa Simple-Matrix-Bot-Lib?

Eseguite questi comandi da una nuova cartella di progetto. Un ambiente virtuale mantiene i pacchetti di questo bot separati dagli altri progetti Python. Il pin di versione rende l'esempio riproducibile con l'ultima versione verificata per questo articolo; in caso di aggiornamento, controllate la versione corrente su PyPI e le relative note di compatibilità.

python3 --version
python3 -m venv .venv
source .venv/bin/activate
python -m pip install "simplematrixbotlib==2.13.1"

Su Windows PowerShell, attiva l'ambiente con .venv\Scripts\Activate.ps1invece del sourcecomando. Quindi crea un file denominato bot.py. La pagina del progetto di PyPI documenta il nome del pacchetto e il comando di installazione, e il suo esempio pubblicato utilizza Creds, Bot, un listener di messaggi e MessageMatch. Vedi l'esempio di utilizzo corrente di PyPI .

Comandi da terminale per creare un ambiente virtuale Python, attivarlo e installare simplematrixbotlib versione 2.13.1
Il terminale mostra l'ambiente isolato e i comandi di installazione dei pacchetti bloccati per il progetto del bot.

Come si collega l'account del bot e si aggiunge un comando?

Salvare il seguente file come bot.py. Richiede la password del bot all'avvio, quindi la password non viene scritta nel file sorgente. Per la distribuzione automatica del servizio, leggere il segreto dal gestore dei segreti del sistema operativo o da una variabile d'ambiente protetta anziché inserirlo direttamente nel codice. Trattare qualsiasi sessione o token di accesso creato dalla libreria come una credenziale: mantenerlo privato e non includerlo nel controllo di versione.

import getpass
import simplematrixbotlib as botlib

creds = botlib.Creds(
    homeserver="https://matrix.example.org",
    username="echo_bot",
    password=getpass.getpass("Bot password: "),
)
bot = botlib.Bot(creds)
PREFIX = "!"

@bot.listener.on_message_event
async def echo(room, message):
    match = botlib.MessageMatch(room, message, bot, PREFIX)
    if (match.is_not_from_this_bot()
            and match.prefix()
            and match.command("echo")):
        text = " ".join(match.args())
        reply = text or "Usage: !echo <text>"
        await bot.api.send_text_message(room.room_id, reply)

bot.run()

Sostituisci l'URL di esempio del server home con l'URL di base del tuo server e usa il nome utente e la password dell'account del bot. Il listener riceve i messaggi della stanza; MessageMatchsi assicura di ignorare i propri messaggi e gestisce solo il !echocomando. La chiamata API invia le parole rimanenti alla stessa stanza. Questi nomi e chiamate di metodo seguono l'esempio pubblicato dalla libreria su PyPI. Confronta con la guida rapida di Simple-Matrix-Bot-Lib .

Editor Python che mostra le importazioni, un prompt getpass, le credenziali di Matrix homeserver e echo_bot e l'inizializzazione del bot.
Il blocco credenziali utilizza un account dedicato e richiede la password anziché memorizzare il segreto in un file.
Editor Python che mostra il listener on_message_event, i controlli MessageMatch e la chiamata send_text_message
Il gestore ignora i messaggi del bot, corrisponde al comando !echo e rimanda i suoi argomenti alla stanza.

Come si esegue il bot e si verifica che funzioni correttamente?

Dall'ambiente virtuale attivato, eseguire:

python bot.py

Inserisci la password dell'account del bot quando richiesto. Nella stanza di prova, invia !echo hello. Un bot di base funzionante risponde hello. Se non risponde, verifica che l'account del bot si sia unito a quella stanza, che l'utente abbia il permesso di inviare messaggi lì, che l'URL del server principale sia corretto e che il messaggio inizi con il !prefisso esatto. Mantieni il processo in esecuzione; la chiusura del terminale interrompe questa semplice distribuzione in primo piano.

Stanza di prova in stile Matrix che mostra @you:example.org inviare !echo hello e @echo_bot:example.org rispondere hello
Una conversazione di esempio in una stanza mostra la richiesta e la risposta previste per il comando echo; si tratta di un'illustrazione, non di un risultato di un test reale.

L'esempio non elabora i messaggi di chat crittografati end-to-end. La libreria pubblicizza il supporto E2EE, ma il manuale attualmente disponibile riporta la versione 2.11.0 e potrebbe essere obsoleto; tale manuale descrive matrix-nio[e2e]dipendenze aggiuntive e Config.encryption_enabledun'impostazione. Prima di abilitare la crittografia, verificare i passaggi esatti di installazione e verifica per la versione installata. La documentazione precedente indica anche un'impostazione join_on_invite; invitare il bot solo alle chat a cui dovrebbe avere accesso e verificare tale impostazione se la distribuzione richiede il controllo automatico degli accessi alle chat. Consultare il manuale di configurazione e di crittografia end-to-end della libreria .

La configurazione è completa quando il bot rimane connesso, è membro della stanza di test e risponde !echo hellocon hello. Per la produzione, eseguilo tramite un gestore di processi e proteggi la sua password e i dati di sessione.

Lascia un commento

Elimina i vecchi messaggi e file multimediali di Synapse senza perdere dati.

Utilizza le API di Synapse per la cancellazione della cronologia e dei supporti di memorizzazione o le impostazioni di conservazione per rimuovere in modo sicuro i dati obsoleti, quindi verifica il completamento dell'operazione e il recupero dello spazio su disco.

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Installa la libreria corrente, collega un account Matrix dedicato ed esegui un piccolo bot !echo con una gestione più sicura delle credenziali e un test chiaro.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Configura tre bridge Mautrix con registrazioni, accessi e test separati, ed evita sorprese legate alla rete Docker, alle policy degli account e alla sincronizzazione.

Recupera spazio su disco in Synapse Media senza compromettere i file condivisi.

Scopri cosa occupa spazio di archiviazione in Synapse, imposta la conservazione sicura dei file multimediali e svuota la cache remota senza eliminare i file direttamente dal disco.

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Esamina l'attività del dispositivo, disattiva gli account Synapse inattivi confermati tramite l'API di amministrazione e scopri cosa rimuove effettivamente il flag di cancellazione opzionale.

Ridurre la pressione sulla memoria di PostgreSQL in Matrix Synapse

Scopri se l'utilizzo della memoria PostgreSQL deriva da query, buffer condivisi, connessioni o operazioni di manutenzione, quindi apporta modifiche mirate e compatibili con Synapse.

Perché le connessioni tra le stanze di sinapsi di Matrix sono lente e cosa controllare

Perché le connessioni tra le stanze di sinapsi di Matrix sono lente e cosa controllare

Traccia le connessioni lente alle stanze Matrix verso un homeserver remoto, il backoff della federazione, il caricamento del database locale o una coda di invio in uscita prima di modificare le impostazioni di Synapse.

Chiudere le iscrizioni a Matrix o richiedere token di invito su Synapse

Impedisci la creazione di account aperti su un server Synapse self-hosted oppure mantieni le registrazioni accessibili solo su invito con token di registrazione a utilizzo limitato.

Avviso di identità della sessione Element: verifica le tue credenziali di accesso in modo sicuro

Clear Element offre un sistema di avviso per sessioni non verificate utilizzando un dispositivo attendibile o una chiave di ripristino, con controlli che proteggono la cronologia delle chat crittografate.

Evita i timeout di blocco dei file di ownCloud con il backend giusto

Distingui i conflitti di blocco del database dai blocchi WebDAV scaduti, quindi scegli e configura la soluzione ownCloud 10 più adatta.