Les métadonnées de présentation Matrix d’OpenClaw

Matrix n’a pas de boutons natifs, donc OpenClaw fait autrement que sur les autres canaux : il envoie un message normal avec un corps en texte brut et y attache un objet de présentation structuré qu’un client conscient d’OpenClaw peut rendre en boutons, sélecteurs et lignes de contexte. Voici le contenu de l’événement, les règles de repli qui gardent tous les autres clients fonctionnels, les blocs pris en charge, l’aller-retour des interactions, et les deux règles sur les approbations et les médias.

Le contenu de l’événement

• OpenClaw attache des métadonnées de présentation de message normalisées aux événements de message de salon sortants sous une clé de contenu de présentation OpenClaw ; les clients Matrix standard continuent de rendre le corps en texte brut, et les clients conscients d’OpenClaw peuvent lire les métadonnées structurées et rendre une interface native comme des boutons, des sélecteurs, des lignes de contexte et des séparateurs.
• L’exemple est un message de sélection de modèle dont le corps liste les choix en lignes brutes et dont la présentation porte une version de un, le type de présentation de message, un ton d’information, un titre et un bloc de sélecteur avec un espace réservé et une option dont la valeur est une commande de modèle avec l’indicateur de session.
• La version est la version du schéma, actuellement un, et le type est un discriminateur stable qui vaut toujours présentation de message ; l’adaptateur Matrix n’émet que des charges avec exactement cette version et ce type, et les clients doivent de même ignorer les versions inconnues qu’ils ne peuvent pas interpréter sans risque, les valeurs de type inconnues et les types de blocs inconnus.
• Le titre et le ton, parmi information, succès, avertissement, danger et neutre, sont des indications facultatives, et les boutons et options de sélecteur peuvent porter une action typée, une commande avec sa commande slash ou un rappel avec sa valeur, à côté de la valeur textuelle héritée, l’action étant préférée quand les deux sont présentes.

Les métadonnées structurées sont additives et ne doivent pas être requises pour l’interopérabilité Matrix de base.

Le repli

OpenClaw rend toujours un repli lisible en texte brut dans le corps, et les métadonnées structurées sont additives et ne doivent jamais être requises pour l’interopérabilité de base. Les règles de rendu sont fixes : le titre, le texte et le contexte se rendent en lignes brutes ; les boutons avec une action de commande se rendent en étiquette suivie de la commande pour qu’elle reste copiable, les boutons avec une action de rappel ou une simple valeur héritée se rendent en étiquette seule pour que les valeurs de rappel opaques restent privées, les boutons désactivés sont toujours en étiquette seule, et les boutons d’URL et de web-app se rendent en étiquette et adresse ; les blocs de sélecteur rendent l’espace réservé, ou un titre d’options, plus des lignes d’options en étiquette seule ; et quand rien ne se rend, pour une présentation à séparateur seul, le corps retombe sur trois tirets. Les clients non compatibles continuent d’afficher le texte de repli, et les clients conscients peuvent préférer les métadonnées structurées pour l’affichage tout en préservant le repli pour la copie, la recherche, les notifications et l’accessibilité.

Blocs, interactions, approbations, médias

• L’adaptateur sortant Matrix annonce une prise en charge native des blocs de boutons, de sélecteur, de contexte et de séparateur, les blocs de texte sont toujours pris en charge par le corps de repli, et tous les blocs sont des indications de présentation au mieux, si bien que les champs et types de blocs inconnus sont ignorés plutôt que de faire échouer le message.
• Les métadonnées n’ajoutent aucune sémantique de rappel Matrix : les valeurs des boutons et des sélecteurs sont des charges d’interaction de repli, généralement des commandes slash ou textuelles, si bien qu’un client qui veut l’interaction résout la valeur du contrôle, la commande de l’action d’abord, puis la valeur de l’action, puis la valeur héritée, et la renvoie au salon en message normal, par exemple une commande de modèle avec l’indicateur de session envoyée comme message texte chiffré dans le même salon, où l’indicateur de session explicite empêche une mise à jour de la valeur par défaut configurée quelle que soit la portée de sélection de modèle.
• Les invites d’approbation utilisent la clé de métadonnées d’approbation dédiée parce que les approbations portent un état sensible, des décisions et des détails d’exécution ou d’extension, et un client qui trouve les deux clés sur un événement doit préférer le rendu d’approbation ; quand une réponse contient plusieurs URL de médias, OpenClaw envoie un événement par URL avec la légende et la présentation sur le premier événement seulement, la même règle s’applique quand un long texte est découpé en plusieurs événements, et les métadonnées de présentation restent compactes, le texte volumineux restant dans le corps.

OpenClaw sur Matrix est le billet du canal auquel ces métadonnées appartiennent, et Les messages riches Matrix dans OpenClaw les autres surfaces natives que l’adaptateur propose.

Un message d’abord, un widget ensuite

Concevoir le corps comme source de vérité et les métadonnées comme indication est ce qui permet à un seul message de servir Element, un lecteur d’écran et un client conscient d’OpenClaw à la fois, et pourquoi un clic sur un bouton n’est qu’une commande retapée dans le salon. Messages riches et approbations Telegram dans OpenClaw montre l’approche par clavier intégré de Telegram, où la plateforme possède bien les boutons, et Les approbations d’exécution dans OpenClaw le flux d’approbation qui reçoit ici ses propres métadonnées.

Sur Diali

Matrix figure dans la liste des canaux connectables de Diali, aux côtés de WhatsApp, Telegram, Discord, Slack, Mattermost, des SMS et de la voix : le compte sur le serveur d’accueil et la liste d’autorisation des salons sont à vous, la passerelle est à nous. OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit la frontière qui s’applique à chaque canal connecté.

• Version un, type présentation de message, tout le reste ignorable.
• Les commandes restent copiables dans le repli ; les valeurs de rappel restent privées.
• Les métadonnées voyagent sur le premier événement ; les approbations ont leur propre clé.