Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Începând cu 10 octombrie 2026, PyPI listează Simple-Matrix-Bot-Lib 2.13.1, lansată pe 29 martie 2026. Pachetul necesită Python 3.9 sau o versiune mai nouă, dar Python 3.9 a ajuns la sfârșitul ciclului de viață; utilizați o versiune Python întreținută pe care pachetul o acceptă. Documentația proiectului găzduit încă se identifică ca versiunea 2.11.0 și avertizează că nu este întreținută, așa că acest ghid urmează exemplul PyPI actual pentru API-ul botului și utilizează manualul mai vechi doar pentru notele de configurare clar etichetate. Verificați versiunea pachetului și metadatele pe PyPI . Citiți starea documentației proiectului .

Cea mai rapidă și fiabilă configurare este un utilizator Matrix dedicat, un mediu virtual Python și un mic bot Echo care răspunde !echoîntr-o cameră de testare. Exemplul este pentru o cameră necriptată; camerele criptate necesită configurare suplimentară.

De ce ai nevoie înainte de a instala biblioteca?

Creați sau solicitați un cont obișnuit pe serverul principal care va rula botul. Dați-i un nume de utilizator distinct, cum ar fi echo_bot; nu necesită privilegii de administrator al serverului principal. Înregistrarea poate fi dezactivată sau restricționată de serverul respectiv, așadar urmați politica sa de creare a contului. Invitați contul doar într-o cameră de testare privată unde are voie să trimită mesaje.

Folosește Python 3.11 sau o altă ramură Python acceptată în prezent. Deși metadatele pachetului permit încă Python 3.9, Python.org marchează sfârșitul ciclului de viață al ramurii respective la 31 octombrie 2025, deci valoarea minimă a pachetului nu este o recomandare bună de implementare. Notificare de asistență Python 3.9 de la Python.org .

Cum instalezi Simple-Matrix-Bot-Lib?

Executați aceste comenzi dintr-un folder nou al proiectului. Un mediu virtual păstrează pachetele acestui bot separate de alte proiecte Python. Codul PIN al versiunii face ca exemplul să fie reproductibil față de cea mai recentă versiune verificată pentru acest articol; la actualizare, verificați versiunea curentă PyPI și notele de compatibilitate aferente.

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

În Windows PowerShell, activați mediul cu .venv\Scripts\Activate.ps1în loc de sourcecomanda . Apoi creați un fișier numit bot.py. Pagina de proiect a PyPI documentează numele pachetului și comanda de instalare, iar exemplul publicat utilizează Creds, Bot, un ascultător de mesaje și MessageMatch. Consultați exemplul curent de utilizare PyPI .

Comenzi terminale pentru crearea unui mediu virtual Python, activarea acestuia și instalarea versiunii simplematrixbotlib 2.13.1
Terminalul afișează mediul izolat și comenzile de instalare a pachetelor fixate pentru proiectul bot.

Cum conectezi contul de bot și adaugi o comandă?

Salvați următoarele ca bot.py. Acesta solicită parola botului la pornire, astfel încât parola să nu fie scrisă în fișierul sursă. Pentru implementarea nesupravegheată a serviciului, citiți secretul din managerul de secrete al sistemului de operare sau dintr-o variabilă de mediu protejată în loc să îl codificați hardcode. Tratați orice stocare de sesiune sau token de acces creată de bibliotecă ca o acreditare: păstrați-o privată și în afara controlului versiunilor.

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()

Înlocuiți adresa URL a serverului de bază eșantion cu adresa URL de bază a serverului dvs. și utilizați numele de utilizator și parola contului botului. Listener-ul primește mesaje către cameră; MessageMatchse asigură că ignoră propriile mesaje și gestionează doar !echocomanda. Apelul API trimite cuvintele rămase înapoi către aceeași cameră. Aceste nume și apeluri de metode urmează exemplul PyPI publicat de bibliotecă. Comparați cu ghidul de pornire rapidă Simple-Matrix-Bot-Lib .

Editor Python care afișează importuri, un prompt getpass, acreditările Matrix homeserver și echo_bot și inițializarea botului
Blocul de acreditări folosește un cont dedicat și solicită parola acestuia în loc să plaseze secretul în fișier.
Editorul Python care afișează ascultătorul on_message_event, verificările MessageMatch și apelul send_text_message
Handler-ul ignoră mesajele botului, caută comanda !echo și trimite argumentele sale înapoi în cameră.

Cum rulezi botul și confirmi că funcționează?

Din mediul virtual activat, executați:

python bot.py

Introduceți parola contului de bot când vi se solicită. În camera de testare, trimiteți mesajul !echo hello. Un bot funcțional răspunde hello. Dacă rămâne silențios, confirmați că respectivul cont de bot s-a alăturat acelei camere, că utilizatorul are permisiunea de a trimite mesaje acolo, că adresa URL a serverului principal este corectă și că mesajul începe cu !prefixul exact. Mențineți procesul în desfășurare; închiderea terminalului său oprește această implementare simplă în prim-plan.

Cameră de testare în stil Matrix care afișează @you:example.org trimite !echo hello și @echo_bot:example.org răspunde hello
O conversație într-o cameră exemplu arată solicitarea și răspunsul așteptate pentru comanda echo; este o ilustrare, nu un rezultat al unui test live.

Exemplul nu procesează mesajele din camere criptate end-to-end. Biblioteca promovează suportul E2EE, dar manualul găzduit în prezent este etichetat 2.11.0 și poate fi învechit; manualul respectiv descrie matrix-nio[e2e]dependențe suplimentare și o Config.encryption_enabledsetare. Confirmați pașii exacți de instalare și verificare pentru versiunea pe care o instalați înainte de a activa criptarea. Documentele mai vechi expun, de asemenea, o join_on_invitesetare; invitați botul doar în camerele pe care ar trebui să le acceseze și verificați acea setare dacă implementarea dvs. trebuie să controleze alăturările automate ale camerelor. Consultați manualul E2EE și de configurare al bibliotecii .

Configurarea este completă atunci când botul rămâne autentificat, este membru al camerei de testare și răspunde !echo hellocu hello. Pentru producție, rulați-l sub un manager de procese și protejați parola și datele sesiunii sale.

Lasă un comentariu

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Diagnosticați dacă Synapse a atins limita de fișiere deschise per proces, setați un drop-in systemd pentru serviciul sau worker-ul corect și verificați limita de funcționare.

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Află dacă eroarea este limitată la un singur browser sau la un singur eveniment, apoi folosește cheia de recuperare Element sau un dispozitiv de încredere fără a risca istoricul criptat rămas.

Curățați mesajele și fișierele media vechi din sinapse fără a pierde date

Folosește API-urile sau setările de retenție pentru istoric și epurare media ale Synapse pentru a elimina în siguranță datele învechite, apoi verifică finalizarea și recuperarea spațiului pe disc.

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Instalați biblioteca curentă, conectați un cont Matrix dedicat și rulați un mic bot !echo cu o gestionare mai sigură a acreditărilor și un test clar.

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Configurați trei punți Mautrix cu înregistrări, conectări și teste separate - și evitați surprizele legate de rețelele Docker, politicile de cont și sincronizare.

Recuperați spațiul de pe disc Synapse Media fără a deteriora fișierele partajate

Găsiți ce umple spațiul de stocare Synapse, setați retenția sigură a suporturilor media și goliți memoria cache la distanță fără a șterge fișierele direct de pe disc.

Dezactivarea utilizatorilor inactivi din matrice fără a șterge istoricul camerei

Dezactivarea utilizatorilor inactivi din matrice fără a șterge istoricul camerei

Verifică activitatea dispozitivului, dezactivează conturile Synapse inactive confirmate prin intermediul API-ului Admin și află ce elimină de fapt indicatorul opțional de ștergere.

Reduceți presiunea memoriei PostgreSQL în sinapsa matriceală

Află dacă memoria PostgreSQL provine din interogări, buffere partajate, conexiuni sau mentenanță, apoi fă modificări specifice, sigure pentru sinapse.

De ce sunt lente alăturările la Matrix Synapse Room și ce trebuie verificat

De ce sunt lente alăturările la Matrix Synapse Room și ce trebuie verificat

Urmăriți alăturările lente ale camerei Matrix la un server de acasă la distanță, retragerea temporară a federației, încărcarea bazei de date locale sau o coadă de expediere înainte de a modifica setările Synapse.

Închideți înscrierile la Matrix sau solicitați token-uri de invitație pe Synapse

Opriți crearea de conturi deschise pe un server Synapse auto-găzduit sau mențineți înscrierile doar pe bază de invitație cu token-uri de înregistrare cu utilizare limitată.