Reglas push de Matrix para vistas previas silenciosas

Cuando channels.matrix.streaming.mode es "quiet", OpenClaw transmite la respuesta editando en el mismo lugar un único evento de vista previa. Las vistas previas se envían como eventos m.notice que no generan notificaciones, y la edición finalizada se marca con content["com.openclaw.finalized_preview"] = true. Los clientes de Matrix notifican esa edición final solo si una regla de notificaciones push por usuario coincide con el marcador. Esta página está dirigida a quienes alojan Matrix por cuenta propia y desean instalar esa regla para cada cuenta destinataria.

streaming.mode: "progress" finaliza sus borradores mediante la misma ruta, por lo que la misma regla también se activa para las ediciones finalizadas del modo de progreso.

Si solo se desea el comportamiento de notificaciones estándar de Matrix, se debe usar streaming.mode: "partial" o dejar desactivada la transmisión. Consulte Configuración del canal Matrix.

Requisitos previos

• usuario destinatario = la persona que debe recibir la notificación
• usuario bot = la cuenta de Matrix de OpenClaw que envía la respuesta
• use el token de acceso del usuario destinatario para las llamadas a la API que aparecen a continuación
• haga coincidir sender en la regla de notificaciones push con el MXID completo del usuario bot
• la cuenta destinataria ya debe tener pushers operativos; las reglas de vistas previas silenciosas solo funcionan cuando la entrega normal de notificaciones push de Matrix funciona correctamente

Pasos

{channels: {matrix: {  streaming: { mode: "quiet" },},},}

curl -sS -X POST \"https://matrix.example.org/_matrix/client/v3/login" \-H "Content-Type: application/json" \--data '{"type": "m.login.password","identifier": { "type": "m.id.user", "user": "@alice:example.org" },"password": "REDACTED"}'

curl -sS \-H "Authorization: Bearer $USER_ACCESS_TOKEN" \"https://matrix.example.org/_matrix/client/v3/pushers"

curl -sS -X PUT \"https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname" \-H "Authorization: Bearer $USER_ACCESS_TOKEN" \-H "Content-Type: application/json" \--data '{"conditions": [  { "kind": "event_match", "key": "type", "pattern": "m.room.message" },  {    "kind": "event_property_is",    "key": "content.m\\.relates_to.rel_type",    "value": "m.replace"  },  {    "kind": "event_property_is",    "key": "content.com\\.openclaw\\.finalized_preview",    "value": true  },  { "kind": "event_match", "key": "sender", "pattern": "@bot:example.org" }],"actions": [  "notify",  { "set_tweak": "sound", "value": "default" },  { "set_tweak": "highlight", "value": false }]}'

curl -sS \-H "Authorization: Bearer $USER_ACCESS_TOKEN" \"https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"

Para eliminar la regla más adelante, aplique DELETE a la misma URL de la regla con el token del destinatario.

Notas sobre varios bots

Las reglas de notificaciones push se indexan mediante ruleId: volver a ejecutar PUT con el mismo ID actualiza una única regla. Si varios bots de OpenClaw notifican al mismo destinatario, cree una regla por bot con una coincidencia de remitente distinta.

Las nuevas reglas override definidas por el usuario se insertan antes de las reglas de supresión predeterminadas del servidor, por lo que no se necesita ningún parámetro de orden adicional. La regla solo afecta a las ediciones de vistas previas de solo texto que pueden finalizarse en el mismo lugar; las respuestas multimedia, los mecanismos alternativos para vistas previas obsoletas y los textos finales que activarían menciones de Matrix se entregan, en cambio, como mensajes normales que generan notificaciones.

Notas sobre el servidor doméstico

Contenido relacionado

• Configuración del canal Matrix
• Conceptos de transmisión