---
read_when:
    - Настройка тихой потоковой передачи Matrix для самостоятельно размещенного Synapse или Tuwunel
    - Пользователям нужны уведомления только о завершенных блоках, а не о каждом редактировании предварительного просмотра
summary: Правила push-уведомлений Matrix для каждого получателя для тихих изменений финализированного предпросмотра
title: Правила отправки матрицы для тихих предварительных просмотров
x-i18n:
    generated_at: "2026-06-28T22:35:16Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: e2f037a50a85b350163c74cf6b9cce335ecaaa5cccc762124122ad6d0321a1fa
    source_path: channels/matrix-push-rules.md
    workflow: 16
---

Когда `channels.matrix.streaming` имеет значение `"quiet"`, OpenClaw редактирует одно событие предпросмотра на месте и помечает финальную правку пользовательским флагом содержимого. Клиенты Matrix уведомляют о финальной правке только если push-правило конкретного пользователя совпадает с этим флагом. Эта страница предназначена для операторов, которые самостоятельно размещают Matrix и хотят установить это правило для каждой учетной записи получателя.

Если вам нужно только стандартное поведение уведомлений Matrix, используйте `streaming: "partial"` или оставьте потоковую передачу выключенной. См. [настройку канала Matrix](/ru/channels/matrix#streaming-previews).

## Предварительные требования

- пользователь-получатель = человек, который должен получить уведомление
- пользователь-бот = учетная запись Matrix OpenClaw, которая отправляет ответ
- используйте токен доступа пользователя-получателя для API-вызовов ниже
- сопоставляйте `sender` в push-правиле с полным MXID пользователя-бота
- у учетной записи получателя уже должны работать pushers — правила тихого предпросмотра работают только когда обычная доставка push-уведомлений Matrix исправна

## Шаги

<Steps>
  <Step title="Configure quiet previews">

```json5
{
  channels: {
    matrix: {
      streaming: "quiet",
    },
  },
}
```

  </Step>

  <Step title="Get the recipient's access token">
    По возможности повторно используйте токен существующего клиентского сеанса. Чтобы выпустить новый:

```bash
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="Verify pushers exist">

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

Если pushers не возвращаются, сначала исправьте обычную доставку push-уведомлений Matrix для этой учетной записи.

  </Step>

  <Step title="Install the override push rule">
    OpenClaw помечает финальные текстовые правки предпросмотра с помощью `content["com.openclaw.finalized_preview"] = true`. Установите правило, которое совпадает с этим маркером и с MXID бота как отправителем:

```bash
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 }
    ]
  }'
```

    Замените перед запуском:

    - `https://matrix.example.org`: базовый URL вашего homeserver
    - `$USER_ACCESS_TOKEN`: токен доступа пользователя-получателя
    - `openclaw-finalized-preview-botname`: ID правила, уникальный для каждого бота и получателя (шаблон: `openclaw-finalized-preview-<botname>`)
    - `@bot:example.org`: MXID вашего бота OpenClaw, а не получателя

  </Step>

  <Step title="Verify">

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

Затем протестируйте потоковый ответ. В тихом режиме комната показывает тихий черновой предпросмотр и отправляет уведомление один раз, когда блок или ход завершается.

  </Step>
</Steps>

Чтобы позже удалить правило, выполните `DELETE` для того же URL правила с токеном получателя.

## Примечания для нескольких ботов

Push-правила индексируются по `ruleId`: повторный запуск `PUT` для того же ID обновляет одно правило. Если несколько ботов OpenClaw уведомляют одного и того же получателя, создайте по одному правилу для каждого бота с отдельным совпадением отправителя.

Новые пользовательские правила `override` вставляются перед стандартными правилами подавления, поэтому дополнительный параметр порядка не нужен. Правило влияет только на текстовые правки предпросмотра, которые можно финализировать на месте; резервные варианты для медиа и устаревших предпросмотров используют обычную доставку Matrix.

## Примечания homeserver

<AccordionGroup>
  <Accordion title="Synapse">
    Специальное изменение `homeserver.yaml` не требуется. Если обычные уведомления Matrix уже доходят до этого пользователя, основной шаг настройки — токен получателя и вызов `pushrules` выше.

    Если Synapse работает за обратным прокси или workers, убедитесь, что `/_matrix/client/.../pushrules/` корректно достигает Synapse. Доставку push-уведомлений обрабатывает основной процесс или `synapse.app.pusher` / настроенные pusher workers — убедитесь, что они исправны.

    Правило использует условие push-правила `event_property_is` (MSC3758, push rule v1.10), которое было добавлено в Synapse в 2023 году. Более старые выпуски Synapse принимают вызов `PUT pushrules/...`, но молча никогда не сопоставляют условие — обновите Synapse, если уведомление не приходит при финальной правке предпросмотра.

  </Accordion>

  <Accordion title="Tuwunel">
    Процесс такой же, как для Synapse; для маркера финального предпросмотра не нужна конфигурация, специфичная для Tuwunel.

    Если уведомления исчезают, пока пользователь активен на другом устройстве, проверьте, включен ли `suppress_push_when_active`. Tuwunel добавил этот параметр в 1.4.2 (сентябрь 2025 года), и он может намеренно подавлять push-уведомления на другие устройства, пока одно устройство активно.

  </Accordion>
</AccordionGroup>

## Связанные материалы

- [Настройка канала Matrix](/ru/channels/matrix)
- [Концепции потоковой передачи](/ru/concepts/streaming)