Zum Hauptinhalt springen

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 kann normalisierte MessagePresentation-Metadaten an ausgehende Matrix-m.room.message-Ereignisse unter com.openclaw.presentation anhängen. Standard-Matrix-Clients rendern weiterhin den reinen Text in body. OpenClaw-fähige Clients können die strukturierten Metadaten lesen und native Benutzeroberflächen wie Schaltflächen, Auswahlfelder, Kontextzeilen und Trennlinien rendern.

​
Ereignisinhalt

Die Metadaten werden im Inhalt des Matrix-Ereignisses gespeichert: 
{
  "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 ist die Schemaversion der Matrix-Präsentationsmetadaten. type ist ein stabiler Diskriminator für OpenClaw-fähige Clients. Clients sollten unbekannte type-Werte, unbekannte Versionen, die sie nicht sicher interpretieren können, und unbekannte Blocktypen ignorieren.

​
Fallback-Verhalten

OpenClaw rendert immer einen lesbaren Fallback als reinen Text in body. Die strukturierten Metadaten sind additiv und dürfen nicht für grundlegende Matrix-Interoperabilität erforderlich sein. Nicht unterstützte Clients sollten weiterhin den Fallback-Text anzeigen. OpenClaw-fähige Clients können die strukturierten Metadaten für die Anzeige bevorzugen und zugleich den Fallback-Text für Kopieren, Suche, Benachrichtigungen und Barrierefreiheit beibehalten.

​
Unterstützte Blöcke

Der ausgehende Matrix-Adapter gibt Unterstützung für Folgendes an:
  • buttons
  • select
  • context
  • divider
Clients sollten diese Blöcke als Best-Effort-Präsentationshinweise behandeln. Unbekannte Felder und unbekannte Blocktypen sollten ignoriert werden, statt das Rendern der gesamten Nachricht fehlschlagen zu lassen.

​
Interaktionen

Diese Metadaten fügen keine Matrix-Callback-Semantik hinzu. Werte von Schaltflächen und Auswahloptionen sind Fallback-Interaktions-Payloads, in der Regel Slash-Befehle oder Textbefehle. Ein Matrix-Client, der Interaktion unterstützen möchte, kann den ausgewählten Wert als normale Nachricht zurück in den Raum senden. Beispielsweise kann eine Schaltfläche mit dem Wert /model deepseek/deepseek-chat verarbeitet werden, indem dieser Wert als verschlüsselte Matrix-Textnachricht im selben Raum gesendet wird.

​
Beziehung zu Genehmigungsmetadaten

com.openclaw.presentation ist für allgemeine Rich-Message-Präsentation vorgesehen. Genehmigungsaufforderungen verwenden die dedizierten com.openclaw.approval-Metadaten, da Genehmigungen sicherheitsrelevanten Zustand, Entscheidungen und Ausführungs-/Plugin-Details enthalten. Wenn beide Metadatenschlüssel im selben Ereignis vorhanden sind, sollten Clients den dedizierten Genehmigungs-Renderer bevorzugen.

​
Mediennachrichten

Wenn eine Antwort mehrere Medien-URLs enthält, sendet OpenClaw ein Matrix-Ereignis pro Medien-URL. Präsentationsmetadaten werden nur an das erste Medienereignis angehängt, damit Clients einen stabilen strukturierten Payload haben und doppelte Renderer vermieden werden. Halten Sie Präsentationsmetadaten kompakt. Umfangreicher benutzersichtbarer Text sollte in body verbleiben und den normalen Pfad zur Matrix-Textaufteilung verwenden.