Sessiz önizlemeler için Matrix gönderim kuralları

channels.matrix.streaming 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şaretleyiciyle eşleşirse bu son düzenleme için bildirim gönderir. Bu sayfa, Matrix'i kendi altyapısında barındıran ve bu kuralı her alıcı hesabı için yüklemek isteyen operatörlere yöneliktir.

streaming: "progress" taslaklarını aynı yol üzerinden sonlandırdığından, aynı kural ilerleme modunda sonlandırılan düzenlemeler için de tetiklenir.

Yalnızca standart Matrix bildirim davranışını istiyorsanız streaming: "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 alanını 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ı çalıştığında işler

Adımlar

{channels: {matrix: {  streaming: "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 aynı kural URL'sine alıcının belirteciyle DELETE isteği gönderin.

Birden çok botla ilgili notlar

Anlık bildirim kuralları ruleId ile anahtarlanır: aynı kimliğe yeniden PUT isteği göndermek 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önderici eşleşmesine sahip ayrı bir kural oluşturun.

Kullanıcı tarafından tanımlanan yeni override kuralları, sunucunun varsayılan engelleme kurallarının önüne eklendiğinden ek bir sıralama parametresi gerekmez. Kural yalnızca yerinde sonlandırılabilen salt metin ö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ı