Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw peut joindre des métadonnées MessagePresentation normalisées aux événements Matrix m.room.message sortants sous com.openclaw.presentation. Les clients Matrix standard continuent d’afficher le texte brut body. Les clients compatibles avec OpenClaw peuvent lire les métadonnées structurées et afficher une interface utilisateur native comme des boutons, des sélecteurs, des lignes de contexte et des séparateurs.

​
Contenu de l’événement

Les métadonnées sont stockées dans le contenu de l’événement 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 est la version du schéma des métadonnées de présentation Matrix. type est un discriminateur stable pour les clients compatibles avec OpenClaw. Les clients doivent ignorer les valeurs type inconnues, les versions inconnues qu’ils ne peuvent pas interpréter de façon sûre, ainsi que les types de blocs inconnus.

​
Comportement de repli

OpenClaw affiche toujours un texte brut de repli lisible dans body. Les métadonnées structurées sont additives et ne doivent pas être requises pour l’interopérabilité Matrix de base. Les clients non pris en charge doivent continuer à afficher le texte de repli. Les clients compatibles avec OpenClaw peuvent privilégier les métadonnées structurées pour l’affichage, tout en conservant le texte de repli pour la copie, la recherche, les notifications et l’accessibilité.

​
Blocs pris en charge

L’adaptateur sortant Matrix annonce la prise en charge de :
  • buttons
  • select
  • context
  • divider
Les clients doivent traiter ces blocs comme des indications de présentation fournies au mieux. Les champs inconnus et les types de blocs inconnus doivent être ignorés plutôt que de provoquer l’échec de l’affichage du message entier.

​
Interactions

Ces métadonnées n’ajoutent pas de sémantique de rappel Matrix. Les valeurs des boutons et des options de sélection sont des charges utiles d’interaction de repli, généralement des commandes slash ou des commandes textuelles. Un client Matrix qui veut prendre en charge l’interaction peut renvoyer la valeur sélectionnée dans le salon sous forme de message normal. Par exemple, un bouton dont la valeur est /model deepseek/deepseek-chat peut être géré en envoyant cette valeur comme message texte Matrix chiffré dans le même salon.

​
Relation avec les métadonnées d’approbation

com.openclaw.presentation sert à la présentation générale de messages enrichis. Les invites d’approbation utilisent les métadonnées dédiées com.openclaw.approval, car les approbations transportent un état sensible pour la sécurité, des décisions, ainsi que des détails d’exécution et de plugin. Si les deux clés de métadonnées sont présentes sur le même événement, les clients doivent privilégier le moteur d’affichage dédié aux approbations.

​
Messages multimédias

Lorsqu’une réponse contient plusieurs URL de médias, OpenClaw envoie un événement Matrix par URL de média. Les métadonnées de présentation ne sont jointes qu’au premier événement multimédia, afin que les clients disposent d’une charge utile structurée stable unique et d’éviter les moteurs d’affichage en double. Gardez les métadonnées de présentation compactes. Les grands textes visibles par l’utilisateur doivent rester dans body et utiliser le chemin normal de découpage du texte Matrix.