Protocole de sortie enrichie

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

• MEDIA: pour la livraison de 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 l’interface Control UI

Les pièces jointes distantes MEDIA: doivent être des URL publiques https:. Les URL simples http:, loopback, link-local, privées et les noms d’hôte 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 locales MEDIA: 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 la livraison.

La syntaxe d’image Markdown simple reste du texte par défaut. Les canaux qui associent intentionnellement les réponses d’images Markdown à 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. MEDIA: et les balises de réponse/voix restent des métadonnées de livraison ; [embed ...] est le chemin de rendu enrichi réservé au web. Les médias de résultats d’outils fiables utilisent le même analyseur MEDIA: / [[audio_as_voice]] avant la livraison, de sorte que les sorties textuelles d’outils puissent toujours marquer une pièce jointe audio comme note vocale.

Lorsque le streaming par blocs est activé, MEDIA: reste une métadonnée de livraison unique pour un tour. Si la même URL de média est envoyée dans un bloc diffusé en streaming puis répétée dans la charge finale de l’assistant, OpenClaw livre la pièce jointe une seule fois et supprime le doublon de la charge finale.

# [embed ...]

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

Exemple auto-fermant :

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

Règles :

• [view ...] n’est plus valide pour les nouvelles sorties.
• Les shortcodes d’intégration s’affichent uniquement dans la surface de message de l’assistant.
• Seules les intégrations basées sur des URL sont rendues. Utilisez ref="..." ou url="...".
• Les shortcodes d’intégration HTML en ligne sous forme de bloc ne sont pas rendus.
• L’interface web retire le shortcode du texte visible et affiche l’intégration en ligne.
• MEDIA: 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 d’assistant normalisé/stocké 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
  }
}

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

# Associés

• Adaptateurs RPC
• Typebox