Technical reference
Umfangreiches Ausgabeprotokoll
Die Assistentenausgabe kann eine kleine Gruppe von Liefer-/Rendering-Direktiven enthalten:
- strukturierte Felder
mediaUrl/mediaUrlsfür die Anhangszustellung [[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
Remote-Medienanhänge müssen öffentliche https:-URLs sein. Reine http:,
Loopback-, Link-Local-, private und interne Hostnamen werden als Anhangsdirektiven
ignoriert; serverseitige Medien-Fetcher erzwingen weiterhin ihre eigenen
Netzwerkschutzmechanismen.
Lokale Medienanhänge können absolute Pfade, workspace-relative Pfade oder
home-relative ~/-Pfade verwenden. Sie durchlaufen vor der Zustellung weiterhin
die Datei-Leserichtlinie des Agenten und Medientypprüfungen.
Einfache Markdown-Bildsyntax bleibt standardmäßig Text. Kanäle, die Markdown-Bildantworten
absichtlich Medienanhängen zuordnen, aktivieren dies in ihrem ausgehenden
Adapter; Telegram tut dies, damit  weiterhin zu einer Medienantwort werden kann.
Diese Direktiven sind getrennt. Strukturierte Medienfelder und Antwort-/Voice-Tags sind
Zustellungsmetadaten; [embed ...] ist der rein webbasierte Pfad für Rich Rendering.
Wenn Block-Streaming aktiviert ist, müssen Medien in strukturierten Payload-Feldern übertragen werden. Wenn dieselbe Medien-URL in einem gestreamten Block gesendet und im finalen Assistenten-Payload wiederholt wird, stellt OpenClaw den Anhang einmal zu und entfernt das Duplikat aus dem finalen Payload.
[embed ...]
[embed ...] ist die einzige agentenseitige Rich-Render-Syntax für die Control UI.
Selbstschließendes Beispiel:
[embed ref="cv_123" title="Status" /]Regeln:
[view ...]ist für neue Ausgaben nicht mehr gültig.- Embed-Shortcodes werden nur in der Nachrichtenoberfläche des Assistenten gerendert.
- Nur URL-basierte Embeds werden gerendert. Verwenden Sie
ref="..."oderurl="...". - Inline-HTML-Embed-Shortcodes in Blockform werden nicht gerendert.
- Die Web-UI entfernt den Shortcode aus dem sichtbaren Text und rendert den Embed inline.
- Strukturierte Medien sind kein Embed-Alias und sollten nicht für Rich-Embed-Rendering verwendet werden.
Gespeicherte Rendering-Form
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 }}Gespeicherte/gerenderte Rich-Blöcke verwenden diese canvas-Form direkt. present_view wird nicht erkannt.
