> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Reglas de envío de Matrix para vistas previas silenciosas

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

`streaming: "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 quieres el comportamiento de notificación estándar de Matrix, usa `streaming: "partial"` o deja la transmisión desactivada. Consulta [Configuración del canal Matrix](/es/channels/matrix#streaming-previews).

## Requisitos previos

* usuario destinatario = la persona que debe recibir la notificación
* usuario bot = la cuenta Matrix de OpenClaw que envía la respuesta
* usa el token de acceso del usuario destinatario para las llamadas API siguientes
* haz coincidir `sender` en la regla push con el MXID completo del usuario bot
* la cuenta destinataria ya debe tener pushers funcionales; las reglas de vista previa silenciosa solo funcionan cuando la entrega push normal de Matrix está en buen estado

## Pasos

<Steps>
  <Step title="Configurar vistas previas silenciosas">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      channels: {
        matrix: {
          streaming: "quiet",
        },
      },
    }
    ```
  </Step>

  <Step title="Obtener el token de acceso del destinatario">
    Reutiliza un token de sesión de cliente existente cuando sea posible. Para emitir uno nuevo:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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"
      }'
    ```
  </Step>

  <Step title="Verificar que existan pushers">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -sS \
      -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
      "https://matrix.example.org/_matrix/client/v3/pushers"
    ```

    Si no vuelve ningún pusher, corrige la entrega push normal de Matrix para esta cuenta antes de continuar.
  </Step>

  <Step title="Instalar la regla push de override">
    Instala una regla que coincida con el marcador de vista previa finalizada y con el MXID del bot como remitente:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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 }
        ]
      }'
    ```

    Reemplaza antes de ejecutar:

    * `https://matrix.example.org`: la URL base de tu homeserver
    * `$USER_ACCESS_TOKEN`: el token de acceso del usuario destinatario
    * `openclaw-finalized-preview-botname`: un ID de regla único por bot y por destinatario (patrón: `openclaw-finalized-preview-<botname>`)
    * `@bot:example.org`: el MXID de tu bot de OpenClaw, no el del destinatario
  </Step>

  <Step title="Verificar">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -sS \
      -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
      "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"
    ```

    Luego prueba una respuesta transmitida en streaming. En el modo `quiet`, la sala muestra una vista previa silenciosa del borrador y notifica una vez que el bloque o el turno termina.
  </Step>
</Steps>

Para eliminar la regla más adelante, haz `DELETE` en la misma URL de regla con el token del destinatario.

## Notas para varios bots

Las reglas push se indexan por `ruleId`: volver a ejecutar `PUT` contra el mismo ID actualiza una sola regla. Para varios bots de OpenClaw que notifiquen al mismo destinatario, crea 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 ediciones de vista previa de solo texto que pueden finalizarse en el lugar; las respuestas multimedia, las alternativas para vistas previas obsoletas y los textos finales que activarían menciones de Matrix se entregan en su lugar como mensajes normales con notificación.

## Notas del homeserver

<AccordionGroup>
  <Accordion title="Synapse">
    No se requiere ningún cambio especial en `homeserver.yaml`. Si las notificaciones normales de Matrix ya llegan a este usuario, el token del destinatario y la llamada a `pushrules` anterior son el paso principal de configuración.

    Si ejecutas Synapse detrás de un proxy inverso o workers, asegúrate de que `/_matrix/client/.../pushrules/` llegue correctamente a Synapse. La entrega push la gestiona el proceso principal o `synapse.app.pusher` / los workers pusher configurados; asegúrate de que estén en buen estado.

    La regla usa la condición de regla push `event_property_is` (MSC3758, regla push v1.10), que se agregó a Synapse en 2023. Las versiones anteriores de Synapse aceptan la llamada `PUT pushrules/...`, pero en silencio nunca hacen coincidir la condición; actualiza Synapse si no llega ninguna notificación en una edición de vista previa finalizada.
  </Accordion>

  <Accordion title="Tuwunel">
    El mismo flujo que Synapse; no se necesita configuración específica de Tuwunel para el marcador de vista previa finalizada.

    Si las notificaciones desaparecen mientras el usuario está activo en otro dispositivo, comprueba si `suppress_push_when_active` está habilitado. Tuwunel agregó esta opción en 1.4.2 (septiembre de 2025) y puede suprimir intencionadamente los pushes a otros dispositivos mientras un dispositivo está activo.
  </Accordion>
</AccordionGroup>

## Relacionado

* [Configuración del canal Matrix](/es/channels/matrix)
* [Conceptos de streaming](/es/concepts/streaming)