channels.matrix.streaming.mode, "quiet" olduğunda OpenClaw, tek bir önizleme olayını yerinde düzenleyerek yanıtı akış halinde iletir. Önizlemeler, bildirim oluşturmayan m.notice olayları olarak gönderilir ve tamamlanan düzenleme content["com.openclaw.finalized_preview"] = true ile işaretlenir. Matrix istemcileri, yalnızca kullanıcıya özel bir anında bildirim kuralı işaretleyiciyle eşleşirse bu son düzenleme için bildirim gönderir. Bu sayfa, Matrix’i kendi sunucusunda barındıran ve her alıcı hesabı için bu kuralı yüklemek isteyen operatörlere yöneliktir.
streaming.mode: "progress", taslaklarını aynı yol üzerinden tamamlar; dolayısıyla aynı kural, ilerleme modunda tamamlanan düzenlemeler için de tetiklenir.
Yalnızca standart Matrix bildirim davranışını istiyorsanız streaming.mode: "partial" kullanın veya akışı kapalı bırakın. Bkz. Matrix kanal kurulumu.
Ön koşullar
- alıcı kullanıcı = bildirimi alması gereken kişi
- bot kullanıcısı = yanıtı gönderen OpenClaw Matrix hesabı
- aşağıdaki API çağrıları için alıcı kullanıcının erişim belirtecini kullanın
- anında bildirim kuralındaki
senderdeğerini bot kullanıcısının tam MXID’siyle eşleştirin - alıcı hesabında çalışan anında bildirim göndericileri zaten bulunmalıdır; sessiz önizleme kuralları yalnızca normal Matrix anında bildirim teslimi sağlıklı olduğunda çalışır
Adımlar
1
Sessiz önizlemeleri yapılandırın
2
Alıcının erişim belirtecini alın
Mümkün olduğunda mevcut bir istemci oturumu belirtecini yeniden kullanın. Yeni bir tane oluşturmak için:
3
Anında bildirim göndericilerinin mevcut olduğunu doğrulayın
4
Geçersiz kılan anında bildirim kuralını yükleyin
Tamamlanan önizleme işaretleyicisiyle ve gönderen olarak bot MXID’siyle eşleşen bir kural yükleyin:Çalıştırmadan önce şunları değiştirin:
https://matrix.example.org: ana sunucunuzun temel URL’si$USER_ACCESS_TOKEN: alıcı kullanıcının erişim belirteciopenclaw-finalized-preview-botname: alıcı başına her bot için benzersiz bir kural kimliği (kalıp:openclaw-finalized-preview-<botname>)@bot:example.org: alıcının değil, OpenClaw botunuzun MXID’si
5
Doğrulayın
DELETE isteği gönderin.
Çoklu bot notları
Anında bildirim kurallarıruleId ile anahtarlanır: aynı kimlik için PUT çağrısını yeniden çalıştırmak tek bir kuralı günceller. Aynı alıcıya bildirim gönderen birden fazla OpenClaw botu için, her bot adına farklı bir gönderen eşleşmesine sahip bir kural oluşturun.
Kullanıcı tanımlı yeni override kuralları, sunucunun varsayılan engelleme kurallarının önüne eklenir; dolayısıyla ek bir sıralama parametresi gerekmez. Kural yalnızca yerinde tamamlanabilen salt metin önizleme düzenlemelerini etkiler; medya yanıtları, geçerliliğini yitirmiş önizleme için geri dönüşler ve Matrix bahsetmelerini etkinleştirecek son metinler bunun yerine normal bildirim oluşturan mesajlar olarak teslim edilir.
Ana sunucu notları
Synapse
Synapse
Özel bir
homeserver.yaml değişikliği gerekmez. Normal Matrix bildirimleri bu kullanıcıya zaten ulaşıyorsa alıcı belirteci ve yukarıdaki pushrules çağrısı ana kurulum adımıdır.Synapse’i bir ters proxy veya worker’ların arkasında çalıştırıyorsanız /_matrix/client/.../pushrules/ isteğinin Synapse’e doğru şekilde ulaştığından emin olun. Anında bildirim teslimi ana süreç veya synapse.app.pusher / yapılandırılmış anında bildirim worker’ları tarafından gerçekleştirilir; bunların sağlıklı olduğundan emin olun.Kural, 2023’te Synapse’e eklenen event_property_is anında bildirim kuralı koşulunu (MSC3758, anında bildirim kuralı v1.10) kullanır. Eski Synapse sürümleri PUT pushrules/... çağrısını kabul eder ancak koşulu hiçbir zaman eşleştirmeden sessizce geçer; tamamlanan bir önizleme düzenlemesinde bildirim gelmezse Synapse’i yükseltin.Tuwunel
Tuwunel
Synapse ile aynı akış geçerlidir; tamamlanan önizleme işaretleyicisi için Tuwunel’e özgü bir yapılandırma gerekmez.Kullanıcı başka bir cihazda etkin durumdayken bildirimler kayboluyorsa
suppress_push_when_active seçeneğinin etkin olup olmadığını kontrol edin. Tuwunel bu seçeneği 1.4.2 (Eylül 2025) sürümünde ekledi ve bu seçenek, bir cihaz etkinken diğer cihazlara gönderilen anında bildirimleri kasıtlı olarak engelleyebilir.