Technical reference
Protocol voor rijke uitvoer
Assistentuitvoer geeft instructies voor aflevering/weergave door via enkele speciale kanalen:
- Gestructureerde velden
mediaUrl/mediaUrlsvoor het afleveren van bijlagen. [[audio_as_voice]]voor aanwijzingen over audioweergave.[[reply_to_current]]/[[reply_to:<id>]]voor antwoordmetagegevens.[embed ...]voor uitgebreide weergave in de Control UI.
Gestructureerde mediavelden en [[...]]-tags zijn afleveringsmetagegevens. [embed ...] is het afzonderlijke, uitsluitend voor het web bestemde pad voor uitgebreide weergave; het is geen media-alias.
Mediabijlagen
Externe bijlagen moeten openbare https:-URL's zijn. http:, local loopback, link-local, privé- en interne hostnamen worden geweigerd als bijlage-instructies; mediaservers die media ophalen, passen daarnaast hun eigen netwerkbeveiligingen toe.
Lokale bijlagen accepteren absolute paden, werkruimterelatieve paden of thuisdirectoryrelatieve ~/-paden. Vóór aflevering worden ze nog steeds getoetst aan het bestandsleesbeleid van de agent en aan controles van het mediatype.
Gewone Markdown-afbeeldingssyntaxis () blijft standaard tekst. Kanalen die Markdown-afbeeldingen als media-antwoorden willen behandelen, schakelen dit in via hun uitgaande adapter; Telegram doet dit, zodat  een mediabijlage wordt.
Wanneer blokstreaming is ingeschakeld, moeten media via gestructureerde payloadvelden worden verzonden. Als dezelfde media-URL in een gestreamd blok en opnieuw in de uiteindelijke assistentpayload voorkomt, levert OpenClaw deze eenmaal af en verwijdert het duplicaat uit de uiteindelijke payload.
[embed ...]
[embed ...] is de enige op agents gerichte syntaxis voor uitgebreide weergave in de Control UI. Zelfsluitend voorbeeld:
[embed ref="cv_123" title="Status" /]Regels:
[view ...]is niet langer geldig voor nieuwe uitvoer.- Embed-shortcodes worden alleen weergegeven in het assistentberichtvlak.
- Alleen door URL's ondersteunde embeds worden weergegeven; gebruik
ref="..."ofurl="...". - Inline HTML-embedshortcodes in blokvorm worden niet weergegeven.
- De webinterface verwijdert de shortcode uit de zichtbare tekst en geeft de embed inline weer.
Opgeslagen weergavestructuur
Het genormaliseerde/opgeslagen inhoudsblok van de assistent is een gestructureerd canvas-item:
{ "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 wordt niet herkend; opgeslagen/weergegeven uitgebreide blokken gebruiken altijd deze canvas-structuur.
