Naar hoofdinhoud gaan

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 kan genormaliseerde MessagePresentation-metadata toevoegen aan uitgaande Matrix-m.room.message-gebeurtenissen onder com.openclaw.presentation. Standaard Matrix-clients blijven de platte tekst body weergeven. Clients die OpenClaw ondersteunen kunnen de gestructureerde metadata lezen en native UI weergeven, zoals knoppen, keuzelijsten, contextrijen en scheidingslijnen.

​
Gebeurtenisinhoud

De metadata wordt opgeslagen in Matrix-gebeurtenisinhoud: 
{
  "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 is de schemaversie voor Matrix-presentatiemetadata. type is een stabiele discriminator voor clients die OpenClaw ondersteunen. Clients moeten onbekende type-waarden, onbekende versies die ze niet veilig kunnen interpreteren en onbekende bloktypen negeren.

​
Terugvalgedrag

OpenClaw geeft altijd een leesbare terugval in platte tekst weer in body. De gestructureerde metadata is aanvullend en mag niet vereist zijn voor basale Matrix-interoperabiliteit. Niet-ondersteunde clients moeten de terugvaltekst blijven tonen. Clients die OpenClaw ondersteunen kunnen de voorkeur geven aan de gestructureerde metadata voor weergave, terwijl ze de terugvaltekst behouden voor kopiëren, zoeken, meldingen en toegankelijkheid.

​
Ondersteunde blokken

De uitgaande Matrix-adapter adverteert ondersteuning voor:
  • buttons
  • select
  • context
  • divider
Clients moeten deze blokken behandelen als best-effort presentatiehints. Onbekende velden en onbekende bloktypen moeten worden genegeerd in plaats van ervoor te zorgen dat het volledige bericht niet kan worden weergegeven.

​
Interacties

Deze metadata voegt geen Matrix-callbacksemantiek toe. Waarden van knoppen en selectieopties zijn terugval-interactiepayloads, meestal slash-commando’s of tekstcommando’s. Een Matrix-client die interactie wil ondersteunen, kan de geselecteerde waarde als normaal bericht terugsturen naar de ruimte. Een knop met de waarde /model deepseek/deepseek-chat kan bijvoorbeeld worden afgehandeld door die waarde als versleuteld Matrix-tekstbericht in dezelfde ruimte te verzenden.

​
Relatie tot goedkeuringsmetadata

com.openclaw.presentation is bedoeld voor algemene rijke berichtpresentatie. Goedkeuringsprompts gebruiken de speciale com.openclaw.approval-metadata, omdat goedkeuringen veiligheidsgevoelige status, beslissingen en uitvoerings-/Plugin-details bevatten. Als beide metadatasleutels op dezelfde gebeurtenis aanwezig zijn, moeten clients de voorkeur geven aan de speciale goedkeuringsrenderer.

​
Mediaberichten

Wanneer een antwoord meerdere media-URL’s bevat, verzendt OpenClaw één Matrix-gebeurtenis per media-URL. Presentatiemetadata wordt alleen aan de eerste media-gebeurtenis toegevoegd, zodat clients één stabiele gestructureerde payload hebben en dubbele renderers worden vermeden. Houd presentatiemetadata compact. Grote gebruikerszichtbare tekst moet in body blijven en het normale Matrix-pad voor tekstsegmentatie gebruiken.