> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Protocole de sortie enrichie

La sortie de l’assistant peut transporter un petit ensemble de directives de livraison/rendu :

* champs structurés `mediaUrl` / `mediaUrls` pour 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 de Control UI

Les pièces jointes multimédias distantes doivent être des URL publiques `https:`. Les URL `http:` simples,
loopback, link-local, privées et les noms d’hôtes internes sont ignorés comme directives de pièce jointe ;
les récupérateurs de médias côté serveur appliquent toujours leurs propres protections réseau.

Les pièces jointes multimédias locales peuvent utiliser des chemins absolus, des chemins relatifs à l’espace de travail ou
des chemins relatifs au répertoire personnel `~/`. Elles passent toujours par la politique de lecture de fichiers de l’agent et
les vérifications de type de média avant livraison.

<Warning>
  N’émettez pas de commandes textuelles pour les pièces jointes depuis des outils, plugins, blocs de streaming,
  sorties de navigateur ou actions de message. Utilisez plutôt des champs multimédias structurés.

  Charge utile d’outil de message valide :

  ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
  { "message": "Here is your image.", "mediaUrl": "/workspace/image.png" }
  ```

  Le texte hérité de la réponse finale de l’assistant peut encore être normalisé pour compatibilité, mais
  ce n’est pas un protocole général de plugin/outil.
</Warning>

La syntaxe d’image Markdown simple reste du texte par défaut. Les canaux qui mappent intentionnellement
les réponses d’image Markdown vers des pièces jointes multimédias l’activent dans leur adaptateur sortant ;
Telegram le fait afin que `![alt](url)` puisse toujours devenir une réponse multimédia.

Ces directives sont distinctes. Les champs multimédias structurés et les balises de réponse/voix sont des
métadonnées de livraison ; `[embed ...]` est le chemin de rendu enrichi réservé au web.

Lorsque le streaming par blocs est activé, les médias doivent être transportés dans des champs de charge utile
structurés. Si la même URL de média est envoyée dans un bloc diffusé en streaming et répétée dans la
charge utile finale de l’assistant, OpenClaw livre la pièce jointe une seule fois et supprime le doublon
de la charge utile finale.

## `[embed ...]`

`[embed ...]` est la seule syntaxe de rendu enrichi exposée à l’agent pour Control UI.

Exemple autofermant :

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
[embed ref="cv_123" title="Status" /]
```

Règles :

* `[view ...]` n’est plus valide pour les nouvelles sorties.
* Les codes courts d’intégration sont rendus uniquement dans la surface de message de l’assistant.
* Seules les intégrations adossées à une URL sont rendues. Utilisez `ref="..."` ou `url="..."`.
* Les codes courts d’intégration HTML en ligne sous forme de bloc ne sont pas rendus.
* L’interface utilisateur web supprime le code court du texte visible et rend l’intégration en ligne.
* Le média structuré n’est pas un alias d’intégration et ne doit pas être utilisé pour le rendu d’intégrations enrichies.

## Forme de rendu stockée

Le bloc de contenu normalisé/stocké de l’assistant est un élément `canvas` structuré :

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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
  }
}
```

Les blocs enrichis stockés/rendus utilisent directement cette forme `canvas`. `present_view` n’est pas reconnu.

## Connexe

* [adaptateurs RPC](/fr/reference/rpc)
* [Typebox](/fr/concepts/typebox)