Aturan push Matrix OpenClaw untuk pratinjau senyap

Streaming senyap menyelesaikan setengah dari masalah notifikasi Matrix: bot berhenti berbunyi pada setiap editan. Setengah lainnya ada di sisi homeserver, karena hanya aturan push di akun penerima yang dapat menentukan editan mana yang layak mendapat notifikasi. Halaman ini ditujukan bagi operator yang meng-hosting sendiri Synapse atau Tuwunel dan ingin aturan itu dipasang untuk setiap penerima. Berikut mekanismenya, langkah-langkahnya, aturan untuk banyak bot, dan dua catatan homeserver.

Mekanismenya

• Dengan mode streaming disetel ke quiet, OpenClaw men-stream balasan dengan mengedit satu event pratinjau di tempat; pratinjau dikirim sebagai event notice yang tidak memicu notifikasi, editan final ditandai dengan properti finalised-preview OpenClaw, dan klien memberi notifikasi pada editan final itu hanya jika aturan push per pengguna cocok dengan penandanya.
• Mode progress memfinalisasi draf-nya melalui jalur yang sama, sehingga aturan yang sama juga terpicu untuk editan final mode progress, dan operator yang hanya menginginkan perilaku notifikasi standar menggunakan mode partial atau membiarkan streaming nonaktif.
• Prasyaratnya adalah pengguna penerima yang seharusnya menerima notifikasi, pengguna bot yang mengirim balasan, token akses penerima untuk panggilan API, ID Matrix lengkap bot sebagai pencocokan sender dalam aturan, dan akun penerima yang sudah memiliki pusher yang berfungsi, karena aturan pratinjau senyap hanya bekerja saat pengiriman push normal dalam keadaan sehat.
• Langkah-langkahnya dimulai dengan mengonfigurasi mode quiet di blok saluran dan mendapatkan token akses penerima, menggunakan ulang token sesi klien yang sudah ada jika memungkinkan atau membuat token baru dengan permintaan login kata sandi ke homeserver, lalu mengekspornya untuk panggilan-panggilan berikutnya.

Aturan push diberi kunci berdasarkan ruleId: menjalankan ulang PUT ke ID yang sama akan memperbarui satu aturan.

Memasang aturan

Verifikasi pusher dengan endpoint pushers menggunakan token penerima, dan jika tidak ada yang dikembalikan, perbaiki pengiriman push normal untuk akun itu sebelum melanjutkan. Kemudian pasang aturan push override dengan ID aturan yang unik per bot dan per penerima, mengikuti pola finalised-preview dengan nama bot, yang empat kondisinya mencocokkan tipe event pesan ruangan, tipe relasi replace, properti finalised-preview bernilai true, dan sender yang sama dengan ID lengkap bot, dengan aksi notify, tweak suara default, dan highlight nonaktif; ganti URL homeserver, token, ID aturan, dan ID bot, dengan mengingat bahwa sender adalah bot, bukan penerima. Verifikasi dengan mengambil URL aturan yang sama, lalu uji balasan yang di-stream: dalam mode quiet, ruangan menampilkan pratinjau draf yang senyap dan memberi notifikasi begitu blok atau giliran selesai, dan aturan itu nantinya dihapus dengan melakukan delete pada URL yang sama menggunakan token penerima.

Beberapa bot dan homeserver

• Aturan push diberi kunci berdasarkan ID aturan, jadi menjalankan ulang pemasangan ke ID yang sama akan memperbarui satu aturan, dan beberapa bot OpenClaw yang memberi notifikasi ke penerima yang sama memerlukan satu aturan per bot dengan pencocokan sender yang berbeda; aturan override baru yang ditentukan pengguna disisipkan di depan aturan suppress bawaan server, jadi tidak diperlukan parameter urutan.
• Aturan ini hanya memengaruhi editan pratinjau khusus teks yang dapat difinalisasi di tempat: balasan media, fallback pratinjau basi, dan teks final yang akan mengaktifkan mention Matrix dikirim sebagai pesan biasa yang memicu notifikasi.
• Synapse tidak memerlukan perubahan konfigurasi homeserver, hanya perlu jalur push-rules sampai ke Synapse melalui tata letak proxy atau worker apa pun dan proses pusher dalam keadaan sehat, dan karena aturan ini menggunakan kondisi event-property-is yang ditambahkan ke Synapse pada 2023, rilis lama menerima panggilan pemasangan tetapi diam-diam tidak pernah cocok, jadi editan final yang tidak pernah memicu notifikasi berarti Synapse perlu diperbarui; Tuwunel mengikuti alur yang sama tanpa konfigurasi khusus, dan notifikasi yang hilang saat pengguna aktif di tempat lain mengarah ke opsi suppress-push-when-active yang ditambahkan di 1.4.2, yang sengaja meredam push ke perangkat lain saat salah satu perangkat sedang aktif.

OpenClaw di Matrix adalah artikel saluran yang dilayani aturan ini, dan perilaku pesan Matrix di OpenClaw adalah mode streaming senyap yang dilengkapinya.

Satu aturan per penerima, per bot

Desain ini menempatkan keputusan di sisi penerima: bot hanya menandai editan finalnya, dan setiap orang memasang aturan yang menentukan apakah penanda itu harus berbunyi, per bot, itulah sebabnya ID aturan membawa nama bot. Akun dan homeserver Matrix di OpenClaw membahas cara menjalankan beberapa akun bot pada satu homeserver, dan enkripsi Matrix di OpenClaw membahas verifikasi yang menjaga akun-akun itu tetap tepercaya.

Di Diali

Matrix ada dalam daftar saluran yang dapat dihubungkan di Diali, bersama WhatsApp, Telegram, Discord, Slack, Mattermost, SMS, dan suara: akun homeserver dan daftar izin ruangan adalah milik Anda, Gateway adalah urusan kami. OpenClaw yang di-hosting di Diali adalah asistennya dan keamanan Diali menjelaskan batas yang berlaku untuk setiap saluran yang terhubung.

• Mode quiet menandai editan final; aturan milik penerima berbunyi karenanya.
• Pusher yang sehat dulu, lalu aturan override.
• Synapse lama menerima aturan itu dan tidak pernah mencocokkannya.