Reglas push de Matrix en OpenClaw para vistas previas silenciosas

El streaming silencioso resuelve la mitad del problema de notificaciones de Matrix: el bot deja de sonar con cada edición. La otra mitad está del lado del homeserver, porque solo una regla push en la cuenta del destinatario puede decir qué edición merece una notificación. Esta página es para operadores que alojan Synapse o Tuwunel por su cuenta y quieren instalar esa regla para cada destinatario. Aquí tienes el mecanismo, los pasos, la regla para varios bots y las dos notas sobre homeservers.

El mecanismo

• Con el modo de streaming en quiet, OpenClaw transmite la respuesta editando en el sitio un único evento de vista previa; las vistas previas se envían como eventos notice que no notifican, la edición finalizada se marca con una propiedad de vista previa finalizada de OpenClaw, y los clientes notifican esa edición final solo si una regla push por usuario coincide con el marcador.
• El modo progress finaliza sus borradores por la misma ruta, así que la misma regla también se dispara con las ediciones finalizadas del modo progress, y los operadores que solo quieren el comportamiento de notificación estándar usan el modo partial o dejan el streaming desactivado.
• Los requisitos previos son un usuario destinatario que debe recibir la notificación, el usuario bot que envía la respuesta, el token de acceso del destinatario para las llamadas a la API, el ID de Matrix completo del bot como coincidencia de remitente en la regla y una cuenta de destinatario que ya tenga pushers funcionando, porque las reglas de vista previa silenciosa solo funcionan cuando la entrega push normal está sana.
• Los pasos empiezan por configurar el modo quiet en el bloque del canal y obtener el token de acceso del destinatario, reutilizando un token de sesión de cliente existente cuando sea posible o generando uno con una solicitud de inicio de sesión con contraseña contra el homeserver, y exportándolo para las llamadas siguientes.

Las reglas push se indexan por ruleId: volver a ejecutar PUT contra el mismo ID actualiza una sola regla.

Instalar la regla

Verifica los pushers con el endpoint de pushers usando el token del destinatario y, si no aparece ninguno, arregla la entrega push normal de esa cuenta antes de continuar. Después instala una regla push override con un ID de regla único por bot y por destinatario, siguiendo el patrón de vista previa finalizada con el nombre del bot, cuyas cuatro condiciones coinciden con un tipo de evento de mensaje de sala, un tipo de relación replace, la propiedad de vista previa finalizada en true y el remitente igual al ID completo del bot, con las acciones notify, el tweak de sonido predeterminado y highlight desactivado; reemplaza la URL del homeserver, el token, el ID de regla y el ID del bot, recordando que el remitente es el bot y no el destinatario. Verifica obteniendo la misma URL de la regla y luego prueba una respuesta en streaming: en modo quiet, la sala muestra un borrador de vista previa silencioso y notifica cuando termina el bloque o el turno, y la regla se elimina más adelante borrando la misma URL con el token del destinatario.

Varios bots y homeservers

• Las reglas push se indexan por ID de regla, así que volver a ejecutar la instalación contra el mismo ID actualiza una sola regla, y varios bots de OpenClaw que notifican al mismo destinatario necesitan una regla por bot con una coincidencia de remitente distinta; las nuevas reglas override definidas por el usuario se insertan por delante de las reglas suppress predeterminadas del servidor, así que no hace falta ningún parámetro de orden.
• La regla solo afecta a las ediciones de vista previa de solo texto que pueden finalizarse en el sitio: las respuestas con medios, los respaldos de vista previa obsoleta y los textos finales que activarían menciones de Matrix se entregan en su lugar como mensajes normales que notifican.
• Synapse no necesita ningún cambio en la configuración del homeserver, solo que la ruta de las reglas push llegue a Synapse a través de cualquier proxy o disposición de workers y que el proceso pusher esté sano, y como la regla usa la condición event-property-is que se añadió a Synapse en 2023, las versiones anteriores aceptan la llamada de instalación pero en silencio nunca coinciden, así que una edición finalizada que nunca notifica significa que hay que actualizar; Tuwunel sigue el mismo flujo sin configuración específica, y las notificaciones que desaparecen mientras el usuario está activo en otro sitio apuntan a su opción suppress-push-when-active, añadida en la 1.4.2, que suprime a propósito las notificaciones push a otros dispositivos mientras uno está activo.

OpenClaw en Matrix es el artículo del canal al que sirve esta regla, y el comportamiento de los mensajes de Matrix en OpenClaw, el modo de streaming silencioso que completa.

Una regla por destinatario y por bot

El diseño deja la decisión del lado del destinatario: el bot solo marca su edición final, y cada persona instala una regla que dice si ese marcador debe sonar, por bot, y por eso el ID de regla lleva el nombre del bot. Cuentas y homeservers de Matrix en OpenClaw cubre cómo ejecutar varias cuentas de bot contra un mismo homeserver, y el cifrado de Matrix en OpenClaw, la verificación que mantiene esas cuentas como de confianza.

En Diali

Matrix está en la lista de canales conectables de Diali, junto a WhatsApp, Telegram, Discord, Slack, Mattermost, SMS y voz: la cuenta del homeserver y la lista de salas permitidas son tuyas; el Gateway es nuestro. OpenClaw alojado en Diali es el asistente y la seguridad en Diali describe el límite que se aplica a cada canal conectado.

• El modo quiet marca la edición final; la regla del destinatario hace que suene.
• Primero pushers sanos, luego la regla override.
• Un Synapse antiguo acepta la regla y nunca coincide con ella.