Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Na dzień 10 października 2026 r. PyPI wymienia Simple-Matrix-Bot-Lib 2.13.1, wydaną 29 marca 2026 r. Pakiet wymaga Pythona w wersji 3.9 lub nowszej, ale Python 3.9 osiągnął koniec wsparcia technicznego; należy używać utrzymywanej wersji Pythona, którą obsługuje dany pakiet. W hostowanej dokumentacji projektu nadal widnieje wersja 2.11.0 i ostrzeżenie, że nie jest ona utrzymywana, dlatego niniejszy przewodnik opiera się na aktualnym przykładzie PyPI dla API bota, a starszy podręcznik zawiera jedynie wyraźnie oznaczone uwagi dotyczące konfiguracji. Sprawdź wydanie pakietu i metadane w PyPI . Przeczytaj status dokumentacji projektu .

Najszybszą i niezawodną konfiguracją jest dedykowany użytkownik Matrix, wirtualne środowisko Pythona i mały bot echo, który odpowiada !echow pomieszczeniu testowym. Przykład dotyczy pomieszczenia niezaszyfrowanego; pokoje zaszyfrowane wymagają dodatkowej konfiguracji.

Czego potrzebujesz przed zainstalowaniem biblioteki?

Utwórz lub poproś o utworzenie konta na serwerze domowym, na którym będzie działał bot. Nadaj mu unikalną nazwę użytkownika, taką jak echo_bot; nie potrzebuje on uprawnień administratora serwera domowego. Rejestracja może być wyłączona lub ograniczona przez ten serwer, dlatego należy przestrzegać jego zasad tworzenia kont. Zaproś konto tylko do prywatnego pokoju testowego, gdzie może wysyłać wiadomości.

Użyj Pythona 3.11 lub innej aktualnie obsługiwanej gałęzi Pythona. Chociaż metadane pakietu nadal dopuszczają Pythona 3.9, Python.org oznacza koniec wsparcia dla tej gałęzi z dniem 31 października 2025 r., więc minimalna wersja pakietu nie jest dobrą rekomendacją wdrożenia. Informacja o wsparciu dla Pythona 3.9 na stronie Python.org .

Jak zainstalować Simple-Matrix-Bot-Lib?

Uruchom te polecenia z nowego folderu projektu. Wirtualne środowisko oddziela pakiety tego bota od innych projektów Pythona. Przypięcie wersji umożliwia odtworzenie przykładu w najnowszej wersji zweryfikowanej na potrzeby tego artykułu; podczas aktualizacji sprawdź aktualną wersję PyPI i jej informacje o zgodności.

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

W programie Windows PowerShell aktywuj środowisko za pomocą polecenia .venv\Scripts\Activate.ps1zamiast sourcepolecenia. Następnie utwórz plik o nazwie bot.py. Strona projektu PyPI dokumentuje nazwę pakietu i polecenie instalacji, a w opublikowanym przykładzie użyto Creds, Bot, nasłuchiwacza komunikatów i MessageMatch. Zobacz aktualny przykład użycia PyPI .

Polecenia terminala tworzące środowisko wirtualne Pythona, aktywujące je i instalujące wersję simplematrixbotlib 2.13.1
W terminalu wyświetlane jest odizolowane środowisko i przypięte polecenia instalacji pakietów dla projektu bota.

Jak połączyć konto bota i dodać komendę?

Zapisz poniższy kod jako bot.py. Podczas uruchamiania pojawi się monit o podanie hasła bota, więc hasło nie zostanie zapisane w pliku źródłowym. W przypadku nienadzorowanego wdrażania usługi, zamiast zapisywać je na stałe, należy odczytać klucz tajny z menedżera kluczy tajnych systemu operacyjnego lub z chronionej zmiennej środowiskowej. Traktuj każdą sesję lub magazyn tokenów dostępu utworzony przez bibliotekę jako dane uwierzytelniające: przechowuj je w tajemnicy i poza kontrolą wersji.

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

Zastąp przykładowy adres URL serwera domowego adresem URL swojego serwera bazowego i użyj nazwy użytkownika i hasła konta bota. Nasłuchiwacz odbiera wiadomości z pokoju; MessageMatchignoruje własne wiadomości i obsługuje tylko !echopolecenie. Wywołanie API odsyła pozostałe słowa z powrotem do tego samego pokoju. Te nazwy i wywołania metod są zgodne z opublikowanym przykładem biblioteki PyPI. Porównaj z szybkim startem Simple-Matrix-Bot-Lib .

Edytor Pythona pokazujący importy, monit getpass, dane uwierzytelniające serwera domowego Matrix i echo_bot oraz inicjalizację bota
Blok poświadczeń używa dedykowanego konta i wyświetla monit o podanie hasła zamiast umieszczania hasła w pliku.
Edytor Pythona pokazujący nasłuchiwacz on_message_event, sprawdzenia MessageMatch i wywołanie send_text_message
Program obsługujący ignoruje własne wiadomości bota, dopasowuje polecenie !echo i odsyła swoje argumenty do pokoju.

Jak uruchomić bota i sprawdzić, czy działa?

Z aktywowanego środowiska wirtualnego uruchom:

python bot.py

Wprowadź hasło do konta bota po wyświetleniu monitu. W pokoju testowym wyślij !echo hello. Działający bot odpowiada hello. Jeśli nie odpowiada, sprawdź, czy konto bota dołączyło do tego pokoju, czy użytkownik ma uprawnienia do wysyłania tam wiadomości, czy adres URL serwera domowego jest poprawny, a wiadomość zaczyna się od dokładnego !prefiksu. Nie przerywaj procesu; zamknięcie terminala zatrzymuje to proste wdrożenie na pierwszym planie.

Pokój testowy w stylu Matrix pokazujący @you:example.org wysyła !echo hello i @echo_bot:example.org odpowiada hello
Przykładowa rozmowa w pokoju pokazuje oczekiwane żądanie i odpowiedź na polecenie echo. Jest to ilustracja, a nie wynik testu na żywo.

Przykład nie przetwarza kompleksowo szyfrowanych wiadomości z pokoi. Biblioteka reklamuje obsługę E2EE, ale jej aktualnie hostowany podręcznik nosi oznaczenie 2.11.0 i może być nieaktualny; podręcznik ten opisuje dodatkowe matrix-nio[e2e]zależności i Config.encryption_enabledustawienie. Przed włączeniem szyfrowania sprawdź dokładne kroki instalacji i weryfikacji dla instalowanej wersji. Starsza dokumentacja również udostępnia join_on_inviteustawienie: zaproś bota tylko do pokoi, do których powinien mieć dostęp, i sprawdź to ustawienie, jeśli wdrożenie musi kontrolować automatyczne dołączanie do pokoi. Zapoznaj się z podręcznikiem biblioteki dotyczącym E2EE i konfiguracji .

Konfiguracja jest zakończona, gdy bot pozostaje zalogowany, jest członkiem sali testowej i odpowiada !echo hello. helloW środowisku produkcyjnym należy uruchomić go w menedżerze procesów i zabezpieczyć jego hasło oraz dane sesji.

Zostaw komentarz

Podnieś limit plików Systemd w Synapse bez zgadywania

Podnieś limit plików Systemd w Synapse bez zgadywania

Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Sprawdź, czy błąd dotyczy jednej przeglądarki lub jednego zdarzenia, a następnie użyj klucza odzyskiwania Element lub zaufanego urządzenia, nie ryzykując utraty zaszyfrowanej historii.

Oczyść stare wiadomości i media Synapse bez utraty danych

Użyj interfejsów API Synapse do czyszczenia historii i multimediów lub ustawień przechowywania, aby bezpiecznie usunąć nieaktualne dane, a następnie zweryfikuj ukończenie operacji i odzyskanie miejsca na dysku.

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zainstaluj aktualną bibliotekę, podłącz dedykowane konto Matrix i uruchom małego bota !echo z bezpieczniejszą obsługą poświadczeń i przejrzystym testem.

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Skonfiguruj trzy mosty Mautrix z oddzielnymi rejestracjami, logowaniami i testami, aby uniknąć niespodzianek związanych z siecią Docker, polityką kont i synchronizacją.

Odzyskaj miejsce na dysku Synapse Media bez naruszania współdzielonych plików

Znajdź elementy zapełniające pamięć masową Synapse, ustaw bezpieczne przechowywanie multimediów i wyczyść zdalną pamięć podręczną bez konieczności usuwania plików bezpośrednio z dysku.

Dezaktywuj nieaktywnych użytkowników Matrix bez usuwania historii pokoju

Dezaktywuj nieaktywnych użytkowników Matrix bez usuwania historii pokoju

Przejrzyj aktywność urządzenia, dezaktywuj potwierdzone nieaktywne konta Synapse za pomocą interfejsu API administratora i dowiedz się, co tak naprawdę usuwa opcjonalna flaga usuwania.

Zmniejsz obciążenie pamięci PostgreSQL w Matrix Synapse

Sprawdź, czy pamięć PostgreSQL pochodzi z obsługi zapytań, współdzielonych buforów, połączeń czy konserwacji, a następnie wprowadź ukierunkowane zmiany bezpieczne dla Synapse.

Dlaczego połączenia w pokoju Matrix Synapse są powolne i co należy sprawdzić

Dlaczego połączenia w pokoju Matrix Synapse są powolne i co należy sprawdzić

Śledź powolne dołączanie pokoju Matrix do jednego zdalnego serwera domowego, wycofywanie federacji, obciążenie lokalnej bazy danych lub kolejkę nadawcy wychodzącego przed zmianą ustawień Synapse.

Zamknij rejestrację w Matrix lub wymagaj tokenów zaproszeń w Synapse

Zatrzymaj możliwość tworzenia otwartych kont na samodzielnie hostowanym serwerze Synapse lub zachowaj możliwość rejestracji wyłącznie na zaproszenia, korzystając z tokenów rejestracyjnych o ograniczonym zastosowaniu.