Saltar al contenido principal
La salida del asistente transporta directivas de entrega/renderización mediante algunos canales dedicados:
  • Campos estructurados mediaUrl / mediaUrls para la entrega de archivos adjuntos.
  • [[audio_as_voice]] para indicaciones de presentación de audio.
  • [[reply_to_current]] / [[reply_to:<id>]] para metadatos de respuesta.
  • [embed ...] para renderización enriquecida en la Control UI.
Los campos de medios estructurados y las etiquetas [[...]] son metadatos de entrega. [embed ...] es la ruta separada de renderización enriquecida solo para la web; no es un alias de medios.

​
Archivos adjuntos multimedia

Los archivos adjuntos remotos deben ser URL públicas https:. http:, loopback, link-local, nombres de host privados e internos se rechazan como directivas de adjuntos; los recuperadores de medios del lado del servidor aplican sus propias protecciones de red además de esto. Los archivos adjuntos locales aceptan rutas absolutas, rutas relativas al espacio de trabajo o rutas relativas al inicio ~/. Aun así, pasan por la política de lectura de archivos del agente y las comprobaciones de tipo de medio antes de la entrega.
No emitas comandos de texto para archivos adjuntos desde herramientas, plugins, bloques de streaming, salida del navegador o acciones de mensaje. Usa campos de medios estructurados en su lugar:
{ "message": "Here is your image.", "mediaUrl": "/workspace/image.png" }
El texto heredado de respuesta final aún puede normalizarse por compatibilidad, pero esto no es un protocolo general de plugin/herramienta.
La sintaxis simple de imagen de Markdown (![alt](url)) permanece como texto de forma predeterminada. Los canales que quieren que las imágenes de Markdown se traten como respuestas multimedia optan por ello en su adaptador de salida; Telegram hace esto para que ![alt](url) se convierta en un archivo adjunto multimedia. Cuando el streaming de bloques está habilitado, los medios deben viajar en campos de carga útil estructurados. Si la misma URL de medios aparece en un bloque transmitido y de nuevo en la carga útil final del asistente, OpenClaw la entrega una vez y elimina el duplicado de la carga útil final.

​
[embed ...]

[embed ...] es la única sintaxis de renderización enriquecida orientada al agente para la Control UI. Ejemplo autocerrado: 
[embed ref="cv_123" title="Status" /]
Reglas:
  • [view ...] ya no es válido para salidas nuevas.
  • Los shortcodes de incrustación solo se renderizan en la superficie de mensajes del asistente.
  • Solo se renderizan incrustaciones respaldadas por URL; usa ref="..." o url="...".
  • Los shortcodes de incrustación HTML en línea con forma de bloque no se renderizan.
  • La interfaz web elimina el shortcode del texto visible y renderiza la incrustación en línea.

​
Forma de renderización almacenada

El bloque de contenido del asistente normalizado/almacenado es un elemento estructurado canvas: 
{
  "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 no se reconoce; los bloques enriquecidos almacenados/renderizados siempre usan esta forma canvas.

​
Relacionado