Rich output protocol

Assistant output can carry a small set of delivery/render directives:

• text

  Copy

  MEDIA:
  for attachment delivery
• text

  Copy

  [[audio_as_voice]]
  for audio presentation hints
• text

  Copy

  [[reply_to_current]]
  /
  text

  Copy

  [[reply_to:<id>]]
  for reply metadata
• text

  Copy

  [embed ...]
  for Control UI rich rendering

Remote

attachments must be public URLs. Plain , loopback, link-local, private, and internal hostnames are ignored as attachment directives; server-side media fetchers still enforce their own network guards.

Plain Markdown image syntax stays text by default. Channels that intentionally map Markdown image replies to media attachments opt in at their outbound adapter; Telegram does this so

can still become a media reply.

These directives are separate.

and reply/voice tags remain delivery metadata; is the web-only rich render path. Trusted tool-result media uses the same / parser before delivery, so text tool outputs can still mark an audio attachment as a voice note.

When block streaming is enabled,

remains single-delivery metadata for a turn. If the same media URL is sent in a streamed block and repeated in the final assistant payload, OpenClaw delivers the attachment once and strips the duplicate from the final payload.

text

Copy

[embed ...]

is the only agent-facing rich render syntax for the Control UI.

Self-closing example:

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

Rules:

• text

  Copy

  [view ...]
  is no longer valid for new output.
• Embed shortcodes render in the assistant message surface only.
• Only URL-backed embeds are rendered. Use
  text

  Copy

  ref="..."
  or
  text

  Copy

  url="..."
  .
• Block-form inline HTML embed shortcodes are not rendered.
• The web UI strips the shortcode from visible text and renders the embed inline.
• text

  Copy

  MEDIA:
  is not an embed alias and should not be used for rich embed rendering.

Stored rendering shape

The normalized/stored assistant content block is a structured

item:

json
Copy
{
  "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
  }
}

Stored/rendered rich blocks use this

shape directly. is not recognized.

Related

• RPC adapters
• Typebox