Sessiz önizlemeler için Matrix push kuralları

channels.matrix.streaming.mode değeri "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 sonlandırılmış düzenleme content["com.openclaw.finalized_preview"] = true ile işaretlenir. Matrix istemcileri, yalnızca kullanıcıya özel bir anlık bildirim kuralı işaretçiyle eşleşirse bu son düzenleme için bildirim gönderir. Bu sayfa, Matrix'i kendi sunucularında barındıran ve bu kuralı her alıcı hesabı için yüklemek isteyen operatörlere yöneliktir.

streaming.mode: "progress", taslaklarını aynı yol üzerinden sonlandırır; bu nedenle aynı kural, ilerleme modunda sonlandırılmış 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
• anlık bildirim kuralındaki sender değerini bot kullanıcısının tam MXID'siyle eşleştirin
• alıcı hesabında çalışan anlık bildirim göndericileri zaten bulunmalıdır; sessiz önizleme kuralları yalnızca normal Matrix anlık bildirim teslimatı sağlıklı olduğunda çalışır

Adımlar

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

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"}'

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

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

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

Kuralı daha sonra kaldırmak için alıcının belirteciyle aynı kural URL'sine DELETE isteği gönderin.

Çoklu bot notları

Anlık bildirim kuralları ruleId ile anahtarlanır: aynı kimliğe karşı PUT komutunu 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; bu nedenle ek bir sıralama parametresi gerekmez. Kural yalnızca yerinde sonlandırılabilen, yalnızca metin içeren önizleme düzenlemelerini etkiler; medya yanıtları, eski önizleme geri dönüşleri ve Matrix bahsetmelerini etkinleştirecek son metinler bunun yerine normal bildirim oluşturan mesajlar olarak teslim edilir.

Ana sunucu notları

İlgili

• Matrix kanal kurulumu
• Akış kavramları