Mainstream messaging

Matrix sunum meta verileri

OpenClaw, normalleştirilmiş MessagePresentation meta verilerini giden Matrix m.room.message olaylarına com.openclaw.presentation içerik anahtarı altında ekler.

Standart Matrix istemcileri düz metin body alanını işlemeye devam eder. OpenClaw uyumlu istemciler, yapılandırılmış meta verileri okuyabilir ve düğmeler, seçim alanları, bağlam satırları ve ayırıcılar gibi yerel kullanıcı arabirimi öğelerini işleyebilir.

Olay içeriği

json

{  "msgtype": "m.text",  "body": "Select model\n\nChoose model:\n- DeepSeek",  "com.openclaw.presentation": {    "version": 1,    "type": "message.presentation",    "title": "Select model",    "tone": "info",    "blocks": [      {        "type": "select",        "placeholder": "Choose model",        "options": [          {            "label": "DeepSeek",            "value": "/model deepseek/deepseek-chat"          }        ]      }    ]  }}

version, meta veri şeması sürümüdür; mevcut sürüm 1'dir. type, kararlı bir ayırt edicidir ve her zaman "message.presentation" değerindedir. Matrix bağdaştırıcısı yalnızca tam olarak bu sürüm ve türe sahip yükleri gönderir; istemciler de güvenli biçimde yorumlayamadıkları bilinmeyen sürümleri, bilinmeyen type değerlerini ve bilinmeyen blok türlerini yok saymalıdır.
title ve tone (info, success, warning, danger, neutral) isteğe bağlı ipuçlarıdır.
Düğmeler ve seçim seçenekleri, eski dize value alanının yanı sıra türü belirtilmiş bir action ({ "type": "command", "command": "/..." } veya { "type": "callback", "value": "..." }) taşıyabilir. Her ikisi de mevcutsa action alanını tercih edin.

Geri dönüş davranışı

OpenClaw her zaman okunabilir bir düz metin geri dönüşünü body alanına işler. Yapılandırılmış meta veriler ek niteliktedir ve temel Matrix birlikte çalışabilirliği için gerekli olmamalıdır.

Geri dönüş işleme kuralları:

title, text ve context içeriği düz satırlar olarak işlenir.
command eylemi bulunan düğmeler, komutun kopyalanabilir kalması için etiket: `/komut` biçiminde işlenir. callback eylemi bulunan veya yalnızca eski bir value içeren düğmeler, belirsiz geri çağırma değerlerinin gizli kalması için yalnızca etiketle işlenir; devre dışı bırakılmış düğmeler her zaman yalnızca etiketle işlenir. URL ve web uygulaması düğmeleri etiket: URL biçiminde işlenir.
Seçim blokları, yer tutucuyu (veya Seçenekler: metnini) başlık olarak ve ardından yalnızca etiket içeren seçenek satırlarını işler.
Hiçbir şey işlenmezse, örneğin yalnızca ayırıcı içeren bir sunumda, gövde --- değerine geri döner.

Desteklenmeyen istemciler geri dönüş metnini göstermeye devam eder. OpenClaw uyumlu istemciler, kopyalama, arama, bildirimler ve erişilebilirlik için geri dönüşü korurken görüntüleme amacıyla yapılandırılmış meta verileri tercih edebilir.

Desteklenen bloklar

Matrix giden ileti bağdaştırıcısı aşağıdakiler için yerel destek bildirir:

buttons
select
context
divider

text blokları geri dönüş gövdesi üzerinden her zaman desteklenir. Tüm blokları mümkün olan en iyi şekilde işlenen sunum ipuçları olarak değerlendirin; iletinin tamamını başarısız kılmak yerine bilinmeyen alanları ve blok türlerini yok sayın.

Etkileşimler

Bu meta veriler Matrix geri çağırma semantiği eklemez. Düğme ve seçim değerleri, genellikle eğik çizgi komutları veya metin komutları olan geri dönüş etkileşim yükleridir. Etkileşimi desteklemek isteyen bir Matrix istemcisi, denetim değerini (action.command, ardından action.value, ardından value) çözümler ve normal bir ileti olarak odaya geri gönderir.

Örneğin, /model deepseek/deepseek-chat değerine sahip bir düğme, bu değer aynı odada şifrelenmiş bir Matrix metin iletisi olarak gönderilerek işlenebilir.

Onay meta verileriyle ilişkisi

com.openclaw.presentation, genel zengin ileti sunumu içindir.

Onay istemleri, onaylar güvenlik açısından hassas durum, kararlar ve çalıştırma/Plugin ayrıntıları taşıdığı için özel com.openclaw.approval meta verilerini kullanır. Aynı olayda her iki meta veri anahtarı da bulunuyorsa istemciler özel onay işleyicisini tercih etmelidir.

Medya iletileri

Bir yanıt birden fazla medya URL'si içerdiğinde OpenClaw, her medya URL'si için bir Matrix olayı gönderir. İstemcilerin yinelenen işleyiciler olmadan tek bir kararlı yapılandırılmış yük alması için açıklama metni ve sunum meta verileri yalnızca ilk olaya eklenir. Uzun metin olaylara bölündüğünde de aynı kural geçerlidir: meta veriler yalnızca ilk olayda taşınır.

Sunum meta verilerini kompakt tutun. Kullanıcı tarafından görülebilen büyük metinler body alanında kalmalı ve normal Matrix metin parçalama yolunu kullanmalıdır.

Was this useful?