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.

Geben Sie keine Textbefehle für Anhänge aus Tools, Plugins, Streaming-Blöcken, Browserausgaben oder Nachrichtenaktionen aus. Verwenden Sie stattdessen strukturierte Medienfelder:

{ "message": "Hier ist Ihr Bild.", "mediaUrl": "/workspace/image.png" }

Text aus älteren endgültigen Antworten kann aus Kompatibilitätsgründen weiterhin normalisiert werden, dies ist jedoch kein allgemeines Plugin-/Tool-Protokoll.

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.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Protokoll für Rich-Ausgabe

Medienanhänge

`[embed ...]`

Gespeicherte Rendering-Struktur

Verwandte Themen

​Medienanhänge

​[embed ...]

​Gespeicherte Rendering-Struktur

​Verwandte Themen

Medienanhänge

`[embed ...]`

Gespeicherte Rendering-Struktur

Verwandte Themen