मैट्रिक्स प्रस्तुति मेटाडेटा

OpenClaw बाहर जाने वाले Matrix m.room.message इवेंट में com.openclaw.presentation के अंतर्गत सामान्यीकृत MessagePresentation मेटाडेटा जोड़ सकता है।

मानक Matrix क्लाइंट सादा टेक्स्ट body रेंडर करना जारी रखते हैं। OpenClaw-सजग क्लाइंट संरचित मेटाडेटा पढ़ सकते हैं और बटन, चयन, संदर्भ पंक्तियां, और विभाजक जैसे मूल UI रेंडर कर सकते हैं।

इवेंट सामग्री

मेटाडेटा Matrix इवेंट सामग्री में संग्रहीत होता है:

{  "msgtype": "m.text",  "body": "Select model\n\n- DeepSeek: /model deepseek/deepseek-chat",  "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 Matrix प्रस्तुति मेटाडेटा स्कीमा संस्करण है। type OpenClaw-सजग क्लाइंट के लिए एक स्थिर विभेदक है। क्लाइंट को अज्ञात type मानों, ऐसे अज्ञात संस्करणों जिन्हें वे सुरक्षित रूप से समझ नहीं सकते, और अज्ञात ब्लॉक प्रकारों को अनदेखा करना चाहिए।

फ़ॉलबैक व्यवहार

OpenClaw हमेशा पढ़ने योग्य सादा टेक्स्ट फ़ॉलबैक को body में रेंडर करता है। संरचित मेटाडेटा अतिरिक्त है और बुनियादी Matrix अंतर-संचालन के लिए आवश्यक नहीं होना चाहिए।

असमर्थित क्लाइंट को फ़ॉलबैक टेक्स्ट दिखाना जारी रखना चाहिए। OpenClaw-सजग क्लाइंट प्रदर्शन के लिए संरचित मेटाडेटा को प्राथमिकता दे सकते हैं, जबकि कॉपी, खोज, सूचनाओं, और अभिगम्यता के लिए फ़ॉलबैक टेक्स्ट को सुरक्षित रखते हैं।

समर्थित ब्लॉक

Matrix आउटबाउंड अडैप्टर इनके लिए समर्थन घोषित करता है:

• buttons
• select
• context
• divider

क्लाइंट को इन ब्लॉक को सर्वोत्तम-प्रयास प्रस्तुति संकेतों के रूप में मानना चाहिए। अज्ञात फ़ील्ड और अज्ञात ब्लॉक प्रकारों को पूरे संदेश का रेंडर विफल कराने के बजाय अनदेखा करना चाहिए।

अंतःक्रियाएं

यह मेटाडेटा Matrix कॉलबैक सिमैंटिक्स नहीं जोड़ता। बटन और चयन विकल्प मान फ़ॉलबैक अंतःक्रिया पेलोड होते हैं, आम तौर पर स्लैश कमांड या टेक्स्ट कमांड। कोई Matrix क्लाइंट जो अंतःक्रिया का समर्थन करना चाहता है, चुने गए मान को सामान्य संदेश के रूप में रूम में वापस भेज सकता है।

उदाहरण के लिए, /model deepseek/deepseek-chat मान वाले बटन को उसी रूम में उस मान को एन्क्रिप्टेड Matrix टेक्स्ट संदेश के रूप में भेजकर संभाला जा सकता है।

अनुमोदन मेटाडेटा से संबंध

com.openclaw.presentation सामान्य समृद्ध संदेश प्रस्तुति के लिए है।

अनुमोदन प्रॉम्प्ट समर्पित com.openclaw.approval मेटाडेटा का उपयोग करते हैं, क्योंकि अनुमोदन सुरक्षा-संवेदनशील स्थिति, निर्णय, और exec/plugin विवरण रखते हैं। यदि एक ही इवेंट पर दोनों मेटाडेटा कुंजियां मौजूद हों, तो क्लाइंट को समर्पित अनुमोदन रेंडरर को प्राथमिकता देनी चाहिए।

मीडिया संदेश

जब किसी उत्तर में कई मीडिया URL होते हैं, OpenClaw प्रत्येक मीडिया URL के लिए एक Matrix इवेंट भेजता है। प्रस्तुति मेटाडेटा केवल पहले मीडिया इवेंट से जोड़ा जाता है, ताकि क्लाइंट के पास एक स्थिर संरचित पेलोड हो और डुप्लिकेट रेंडरर से बचा जा सके।

प्रस्तुति मेटाडेटा को संक्षिप्त रखें। बड़ा उपयोगकर्ता-दृश्यमान टेक्स्ट body में रहना चाहिए और सामान्य Matrix टेक्स्ट चंकिंग पथ का उपयोग करना चाहिए।