Protokoll für Rich-Ausgabe

Die Assistentenausgabe übermittelt Zustellungs-/Rendering-Anweisungen über einige dedizierte Kanäle:

• Strukturierte mediaUrl- / mediaUrls-Felder für die Zustellung von Anhängen.
• [[audio_as_voice]] für Hinweise zur Audiodarstellung.
• [[reply_to_current]] / [[reply_to:<id>]] für Antwortmetadaten.
• [embed ...] für Rich Rendering in der Control UI.

Strukturierte Medienfelder und [[...]]-Tags sind Zustellungsmetadaten. [embed ...] ist der separate, ausschließlich webbasierte Pfad für Rich Rendering; es handelt sich nicht um einen Medienalias.

Medienanhänge

Remote-Anhänge müssen öffentliche https:-URLs sein. http:, Loopback-, Link-Local-, private und interne Hostnamen werden als Anhangsanweisungen abgelehnt; serverseitige Medienabrufe wenden zusätzlich ihre eigenen Netzwerkschutzmechanismen an.

Lokale Anhänge akzeptieren absolute Pfade, arbeitsbereichsrelative Pfade oder ~/-Pfade relativ zum Home-Verzeichnis. Vor der Zustellung werden sie weiterhin anhand der Richtlinie für Dateizugriffe des Agenten und der Medientypprüfungen geprüft.

Einfache Markdown-Bildsyntax (![alt](url)) bleibt standardmäßig Text. Kanäle, die Markdown-Bilder als Medienantworten behandeln möchten, aktivieren dies in ihrem ausgehenden Adapter; Telegram tut dies, sodass ![alt](url) zu einem Medienanhang wird.

Wenn Block-Streaming aktiviert ist, müssen Medien über strukturierte Nutzlastfelder übertragen werden. Wenn dieselbe Medien-URL in einem gestreamten Block und erneut in der endgültigen Assistentennutzlast erscheint, stellt OpenClaw sie einmal zu und entfernt das Duplikat aus der endgültigen Nutzlast.

[embed ...]

[embed ...] ist die einzige agentenseitige Rich-Rendering-Syntax für die Control UI. Beispiel mit selbstschließendem Element:

[embed ref="cv_123" title="Status" /]

Regeln:

• [view ...] ist für neue Ausgaben nicht mehr gültig.
• Embed-Shortcodes werden nur auf der Assistentennachrichtenoberfläche gerendert.
• Nur URL-basierte Einbettungen werden gerendert; verwenden Sie ref="..." oder url="...".
• Inline-HTML-Embed-Shortcodes in Blockform werden nicht gerendert.
• Die Web-UI entfernt den Shortcode aus dem sichtbaren Text und rendert die Einbettung inline.

Gespeicherte Rendering-Struktur

Der normalisierte/gespeicherte Inhaltsblock des Assistenten ist ein strukturiertes canvas-Element:

{  "type": "canvas",  "preview": {    "kind": "canvas",    "surface": "assistant_message",    "render": "url",    "viewId": "cv_123",    "url": "/__openclaw__/canvas/documents/cv_123/index.html",    "title": "Status",    "preferredHeight": 320  }}

present_view wird nicht erkannt; gespeicherte/gerenderte Rich-Blöcke verwenden stets diese canvas-Struktur.

Verwandte Themen

• RPC-Adapter
• Typebox