Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

A fecha de 10 de octubre de 2026, PyPI lista Simple-Matrix-Bot-Lib 2.13.1, publicado el 29 de marzo de 2026. El paquete requiere Python 3.9 o posterior, pero Python 3.9 ha llegado al final de su ciclo de vida; utilice una versión de Python mantenida que sea compatible con el paquete. La documentación del proyecto alojado todavía se identifica como versión 2.11.0 y advierte que no recibe mantenimiento, por lo que esta guía sigue el ejemplo actual de PyPI para la API del bot y utiliza el manual anterior solo para notas de configuración claramente etiquetadas. Compruebe la versión del paquete y los metadatos en PyPI . Lea el estado de la documentación del proyecto .

La configuración más rápida y fiable consiste en un usuario dedicado de Matrix, un entorno virtual de Python y un pequeño bot de eco que responda !echoen una sala de pruebas. El ejemplo es para una sala sin cifrar; las salas cifradas requieren una configuración adicional.

¿Qué necesitas antes de instalar la biblioteca?

Crea o solicita una cuenta normal en el servidor principal que ejecutará el bot. Asígnale un nombre de usuario único, como echo_bot; no necesita privilegios de administrador del servidor principal. El registro puede estar deshabilitado o restringido por ese servidor, así que sigue su política de creación de cuentas. Invita a la cuenta solo a una sala de pruebas privada donde tenga permiso para enviar mensajes.

Utilice Python 3.11 u otra rama de Python compatible actualmente. Aunque los metadatos del paquete aún permiten Python 3.9, Python.org indica que esa rama dejará de tener soporte el 31 de octubre de 2025, por lo que la versión mínima del paquete no es una buena recomendación de implementación. Consulte el aviso de compatibilidad con Python 3.9 de Python.org .

¿Cómo se instala Simple-Matrix-Bot-Lib?

Ejecuta estos comandos desde una nueva carpeta de proyecto. Un entorno virtual mantiene los paquetes de este bot separados de otros proyectos de Python. La especificación de la versión permite reproducir el ejemplo con la última versión verificada para este artículo; al actualizar, consulta la versión actual de PyPI y sus notas de compatibilidad.

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

En Windows PowerShell, active el entorno con .venv\Scripts\Activate.ps1en lugar del sourcecomando. Luego cree un archivo llamado bot.py. La página del proyecto de PyPI documenta el nombre del paquete y el comando de instalación, y su ejemplo publicado utiliza Creds, Bot, un oyente de mensajes y MessageMatch. Consulte el ejemplo de uso actual de PyPI .

Comandos de terminal para crear un entorno virtual de Python, activarlo e instalar la versión 2.13.1 de simplematrixbotlib.
La terminal muestra el entorno aislado y los comandos de instalación de paquetes fijados para el proyecto del bot.

¿Cómo se conecta la cuenta del bot y se añade un comando?

Guarda lo siguiente como bot.py. Se te pedirá la contraseña del bot al iniciar, por lo que la contraseña no se escribirá en el archivo fuente. Para la implementación de servicios desatendidos, lee el secreto del administrador de secretos de tu sistema operativo o de una variable de entorno protegida en lugar de codificarlo directamente. Trata cualquier almacenamiento de sesión o token de acceso creado por la biblioteca como una credencial: mantenlo privado y fuera del control de versiones.

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

Reemplace la URL de ejemplo del servidor principal con la URL base de su servidor y use el nombre de usuario y la contraseña de la cuenta del bot. El oyente recibe los mensajes de la sala; MessageMatchse asegura de ignorar sus propios mensajes y solo procesa el !echocomando. La llamada a la API envía las palabras restantes de vuelta a esa misma sala. Estos nombres y llamadas a métodos siguen el ejemplo publicado en PyPI de la biblioteca. Compárelo con la guía de inicio rápido de Simple-Matrix-Bot-Lib .

Editor de Python que muestra las importaciones, una solicitud de getpass, las credenciales de Matrix homeserver y echo_bot, y la inicialización del bot.
El bloque de credenciales utiliza una cuenta dedicada y solicita su contraseña en lugar de guardar el secreto en el archivo.
Editor de Python que muestra el oyente on_message_event, las comprobaciones de MessageMatch y la llamada send_text_message.
El controlador ignora los mensajes del propio bot, coincide con el comando !echo y envía sus argumentos de vuelta a la sala.

¿Cómo se ejecuta el bot y se confirma que funciona?

Desde el entorno virtual activado, ejecute:

python bot.py

Introduce la contraseña de la cuenta del bot cuando se te solicite. En la sala de pruebas, envía !echo hello. Un bot básico que funciona correctamente responde hello. Si no responde, confirma que la cuenta del bot se ha unido a esa sala, que el usuario tiene permiso para enviar mensajes allí, que la URL del servidor principal es correcta y que el mensaje comienza con el !prefijo exacto. Mantén el proceso en ejecución; cerrar su terminal detiene esta sencilla implementación en primer plano.

Sala de pruebas al estilo Matrix que muestra a @you:example.org enviando !echo hello y @echo_bot:example.org respondiendo hello
Una conversación de ejemplo en una sala muestra la solicitud y la respuesta esperadas para el comando echo; se trata de una ilustración, no del resultado de una prueba real.

La muestra no procesa mensajes de sala cifrados de extremo a extremo. La biblioteca anuncia compatibilidad con E2EE, pero su manual alojado actualmente está etiquetado como 2.11.0 y puede estar desactualizado; dicho manual describe matrix-nio[e2e]dependencias adicionales y una Config.encryption_enabledconfiguración. Confirme los pasos exactos de instalación y verificación para la versión que instale antes de habilitar el cifrado. La documentación anterior también expone una join_on_inviteconfiguración; invite al bot solo a las salas a las que debería tener acceso y verifique esa configuración si su implementación debe controlar las entradas automáticas a las salas. Revise el manual de configuración y E2EE de la biblioteca .

La configuración se completa cuando el bot permanece conectado, es miembro de la sala de pruebas y responde !echo hellocon hello. Para producción, ejecútelo bajo un administrador de procesos y proteja su contraseña y los datos de su sesión.

Dejar un comentario

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Diagnostique si Synapse alcanzó su límite de archivos abiertos por proceso, configure un archivo de configuración de systemd para el servicio o trabajador adecuado y verifique el límite en tiempo real.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

Averigua si el error se limita a un navegador o a un evento específico y, a continuación, utiliza la clave de recuperación de Element o un dispositivo de confianza sin poner en riesgo el historial cifrado restante.

Limpia los mensajes y archivos multimedia antiguos de Synapse sin perder datos.

Utilice las API de historial y eliminación de medios de Synapse o la configuración de retención para eliminar datos obsoletos de forma segura y, a continuación, verifique que el proceso se haya completado y que se haya recuperado el espacio en disco.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Instala la biblioteca actual, conecta una cuenta Matrix dedicada y ejecuta un pequeño bot !echo con un manejo de credenciales más seguro y una prueba clara.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Configure tres puentes mautrix con registros, inicios de sesión y pruebas independientes, y evite sorpresas con la red, la política de cuentas y la sincronización de Docker.

Recupera espacio en disco de Synapse Media sin dañar los archivos compartidos.

Descubre qué está llenando el almacenamiento de Synapse, configura la retención segura de medios y purga la caché remota sin eliminar archivos directamente del disco.

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Revise la actividad del dispositivo, desactive las cuentas de Synapse inactivas confirmadas a través de la API de administración y descubra qué elimina realmente la opción de borrado.

Reduzca la presión de memoria de PostgreSQL en Matrix Synapse.

Determine si la memoria de PostgreSQL proviene del trabajo de consultas, búferes compartidos, conexiones o mantenimiento, y luego realice los cambios necesarios de forma segura para Synapse.

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

Antes de cambiar la configuración de Synapse, analice si hay problemas con las conexiones lentas de salas Matrix a un servidor remoto, el retroceso de la federación, la carga de la base de datos local o una cola de envío saliente.

Cerrar registros de Matrix o requerir tokens de invitación en Synapse

Impida la creación de cuentas abiertas en un servidor Synapse autogestionado o mantenga los registros solo por invitación con tokens de registro de uso limitado.