Inicio
» Cómo
»
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.
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.
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 .
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 .
El bloque de credenciales utiliza una cuenta dedicada y solicita su contraseña en lugar de guardar el secreto en el archivo.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.
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.