Langsung ke konten utama

​
Aturan push Matrix untuk pratinjau senyap

Saat channels.matrix.streaming bernilai "quiet", OpenClaw mengedit satu event pratinjau di tempat dan menandai edit yang telah difinalkan dengan flag konten kustom. Klien Matrix hanya memberi notifikasi pada edit final jika aturan push per pengguna cocok dengan flag tersebut. Halaman ini ditujukan untuk operator yang meng-host Matrix sendiri dan ingin memasang aturan itu untuk setiap akun penerima. Jika Anda hanya menginginkan perilaku notifikasi Matrix bawaan, gunakan streaming: "partial" atau biarkan streaming nonaktif. Lihat penyiapan channel Matrix.

​
Prasyarat

  • pengguna penerima = orang yang harus menerima notifikasi
  • pengguna bot = akun Matrix OpenClaw yang mengirim balasan
  • gunakan access token pengguna penerima untuk panggilan API di bawah ini
  • cocokkan sender dalam aturan push dengan MXID lengkap pengguna bot
  • akun penerima harus sudah memiliki pusher yang berfungsi — aturan pratinjau senyap hanya berfungsi jika pengiriman push Matrix normal dalam keadaan sehat

​
Langkah-langkah

1

Konfigurasikan pratinjau senyap

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

Dapatkan access token penerima

Gunakan ulang token sesi klien yang sudah ada jika memungkinkan. Untuk membuat yang baru:
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"
  }'
3

Verifikasi bahwa pusher ada

curl -sS \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  "https://matrix.example.org/_matrix/client/v3/pushers"
Jika tidak ada pusher yang dikembalikan, perbaiki pengiriman push Matrix normal untuk akun ini sebelum melanjutkan.
4

Pasang aturan push override

OpenClaw menandai edit pratinjau finalized yang hanya berisi teks dengan content["com.openclaw.finalized_preview"] = true. Pasang aturan yang cocok dengan penanda tersebut serta MXID bot sebagai sender:
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 }
    ]
  }'
Ganti sebelum menjalankan:
  • https://matrix.example.org: URL dasar homeserver Anda
  • $USER_ACCESS_TOKEN: access token pengguna penerima
  • openclaw-finalized-preview-botname: ID aturan yang unik per bot per penerima (pola: openclaw-finalized-preview-<botname>)
  • @bot:example.org: MXID bot OpenClaw Anda, bukan milik penerima
5

Verifikasi

curl -sS \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"
Lalu uji balasan yang di-streaming. Dalam mode senyap, room menampilkan pratinjau draf senyap dan memberi notifikasi satu kali saat blok atau giliran selesai.
Untuk menghapus aturan nanti, lakukan DELETE pada URL aturan yang sama dengan token penerima.

​
Catatan multi-bot

Aturan push dikunci oleh ruleId: menjalankan ulang PUT terhadap ID yang sama akan memperbarui satu aturan. Untuk beberapa bot OpenClaw yang memberi notifikasi kepada penerima yang sama, buat satu aturan per bot dengan kecocokan sender yang berbeda. Aturan override baru yang ditentukan pengguna disisipkan sebelum aturan penekanan bawaan, jadi tidak diperlukan parameter pengurutan tambahan. Aturan ini hanya memengaruhi edit pratinjau hanya-teks yang bisa difinalkan di tempat; fallback media dan fallback pratinjau kedaluwarsa menggunakan pengiriman Matrix normal.

​
Catatan homeserver

Tidak diperlukan perubahan homeserver.yaml khusus. Jika notifikasi Matrix normal sudah sampai ke pengguna ini, token penerima + panggilan pushrules di atas adalah langkah penyiapan utama.Jika Anda menjalankan Synapse di belakang reverse proxy atau workers, pastikan /_matrix/client/.../pushrules/ diteruskan ke Synapse dengan benar. Pengiriman push ditangani oleh proses utama atau synapse.app.pusher / worker pusher yang dikonfigurasi — pastikan semuanya sehat.
Alurnya sama seperti Synapse; tidak diperlukan konfigurasi khusus Tuwunel untuk penanda pratinjau finalized.Jika notifikasi menghilang saat pengguna aktif di perangkat lain, periksa apakah suppress_push_when_active diaktifkan. Tuwunel menambahkan opsi ini di 1.4.2 (September 2025) dan opsi ini dapat dengan sengaja menekan push ke perangkat lain saat satu perangkat aktif.

​
Terkait