Vai al contenuto principale
L’output dell’assistente può contenere un piccolo insieme di direttive di consegna/rendering:
  • campi strutturati mediaUrl / mediaUrls per la consegna degli allegati
  • [[audio_as_voice]] per suggerimenti di presentazione audio
  • [[reply_to_current]] / [[reply_to:<id>]] per i metadati di risposta
  • [embed ...] per il rendering avanzato nella Control UI
Gli allegati multimediali remoti devono essere URL https: pubblici. http: semplice, loopback, link-local, nomi host privati e interni vengono ignorati come direttive per gli allegati; i fetcher multimediali lato server applicano comunque le proprie protezioni di rete. Gli allegati multimediali locali possono usare percorsi assoluti, percorsi relativi al workspace o percorsi relativi alla home ~/. Passano comunque attraverso la policy di lettura file dell’agente e i controlli del tipo di media prima della consegna.
Non emettere comandi di testo per gli allegati da strumenti, plugin, blocchi di streaming, output del browser o azioni dei messaggi. Usa invece campi multimediali strutturati.Payload valido per lo strumento di messaggistica:
{ "message": "Here is your image.", "mediaUrl": "/workspace/image.png" }
Il testo legacy della risposta finale dell’assistente può ancora essere normalizzato per compatibilità, ma non è un protocollo generale per plugin/strumenti.
La sintassi Markdown semplice per le immagini resta testo per impostazione predefinita. I canali che mappano intenzionalmente le risposte immagine Markdown ad allegati multimediali lo abilitano nel proprio adattatore in uscita; Telegram lo fa affinché ![alt](url) possa ancora diventare una risposta multimediale. Queste direttive sono separate. I campi multimediali strutturati e i tag di risposta/voce sono metadati di consegna; [embed ...] è il percorso di rendering avanzato solo web. Quando lo streaming a blocchi è abilitato, i media devono essere trasportati in campi di payload strutturati. Se lo stesso URL multimediale viene inviato in un blocco in streaming e ripetuto nel payload finale dell’assistente, OpenClaw consegna l’allegato una sola volta e rimuove il duplicato dal payload finale.

​
[embed ...]

[embed ...] è l’unica sintassi di rendering avanzato esposta agli agenti per la Control UI. Esempio autochiudente: 
[embed ref="cv_123" title="Status" /]
Regole:
  • [view ...] non è più valido per il nuovo output.
  • Gli shortcode embed vengono renderizzati solo nella superficie del messaggio dell’assistente.
  • Vengono renderizzati solo gli embed basati su URL. Usa ref="..." o url="...".
  • Gli shortcode embed HTML inline in forma di blocco non vengono renderizzati.
  • L’interfaccia web rimuove lo shortcode dal testo visibile e renderizza l’embed inline.
  • I media strutturati non sono un alias di embed e non devono essere usati per il rendering di embed avanzati.

​
Forma di rendering memorizzata

Il blocco di contenuto normalizzato/memorizzato dell’assistente è un elemento canvas strutturato: 
{
  "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
  }
}
I blocchi avanzati memorizzati/renderizzati usano direttamente questa forma canvas. present_view non viene riconosciuto.

​
Correlati