Acasă
» Cum să
»
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
Î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.
Î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 .
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 .
Blocul de acreditări folosește un cont dedicat și solicită parola acestuia în loc să plaseze secretul în fișier.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.
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.