Technical reference
Protocole de sortie enrichie
La sortie de l’assistant transmet les directives de livraison et de rendu par l’intermédiaire de quelques canaux dédiés :
- Les champs structurés
mediaUrl/mediaUrlspour la livraison des pièces jointes. [[audio_as_voice]]pour les indications de présentation audio.[[reply_to_current]]/[[reply_to:<id>]]pour les métadonnées de réponse.[embed ...]pour le rendu enrichi dans l’interface de contrôle.
Les champs multimédias structurés et les balises [[...]] sont des métadonnées de livraison. [embed ...] constitue le chemin distinct de rendu enrichi réservé au Web ; ce n’est pas un alias de contenu multimédia.
Pièces jointes multimédias
Les pièces jointes distantes doivent être des URL publiques en https:. Les URL en http:, les adresses local loopback ou lien-local, ainsi que les noms d’hôtes privés et internes, sont rejetés comme directives de pièce jointe ; les mécanismes de récupération de médias côté serveur appliquent en plus leurs propres protections réseau.
Les pièces jointes locales acceptent les chemins absolus, les chemins relatifs à l’espace de travail ou les chemins ~/ relatifs au répertoire personnel. Elles restent soumises à la politique de lecture des fichiers de l’agent et aux vérifications du type de média avant leur livraison.
La syntaxe d’image Markdown simple () reste du texte par défaut. Les canaux qui souhaitent traiter les images Markdown comme des réponses multimédias l’activent dans leur adaptateur sortant ; Telegram le fait afin que  devienne une pièce jointe multimédia.
Lorsque la diffusion par blocs est activée, les médias doivent être transmis dans les champs structurés de la charge utile. Si la même URL de média apparaît dans un bloc diffusé puis de nouveau dans la charge utile finale de l’assistant, OpenClaw ne la livre qu’une seule fois et supprime le doublon de la charge utile finale.
[embed ...]
[embed ...] est la seule syntaxe de rendu enrichi destinée aux agents pour l’interface de contrôle. Exemple à fermeture automatique :
[embed ref="cv_123" title="Status" /]Règles :
[view ...]n’est plus valide pour les nouvelles sorties.- Les codes courts d’intégration sont uniquement rendus dans la surface des messages de l’assistant.
- Seules les intégrations adossées à une URL sont rendues ; utilisez
ref="..."ouurl="...". - Les codes courts d’intégration HTML en ligne sous forme de bloc ne sont pas rendus.
- L’interface Web retire le code court du texte visible et affiche l’intégration en ligne.
Forme de rendu stockée
Le bloc de contenu normalisé et stocké de l’assistant est un élément canvas structuré :
{ "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 n’est pas reconnu ; les blocs enrichis stockés et rendus utilisent toujours cette forme canvas.
