Pular para o conteúdo principal
A saída do assistente pode carregar um pequeno conjunto de diretivas de entrega/renderização:
  • campos estruturados mediaUrl / mediaUrls para entrega de anexos
  • [[audio_as_voice]] para dicas de apresentação de áudio
  • [[reply_to_current]] / [[reply_to:<id>]] para metadados de resposta
  • [embed ...] para renderização rica da Control UI
Anexos de mídia remota devem ser URLs https: públicas. http: simples, loopback, link-local, nomes de host privados e internos são ignorados como diretivas de anexo; os buscadores de mídia do lado do servidor ainda aplicam suas próprias proteções de rede. Anexos de mídia local podem usar caminhos absolutos, caminhos relativos ao workspace ou caminhos relativos ao diretório inicial ~/. Eles ainda passam pela política de leitura de arquivos do agente e por verificações de tipo de mídia antes da entrega.
Não emita comandos de texto para anexos de ferramentas, plugins, blocos de streaming, saída do navegador ou ações de mensagem. Use campos de mídia estruturados.Payload válido da ferramenta de mensagens:
{ "message": "Here is your image.", "mediaUrl": "/workspace/image.png" }
O texto legado da resposta final do assistente ainda pode ser normalizado por compatibilidade, mas não é um protocolo geral de plugin/ferramenta.
A sintaxe simples de imagem em Markdown permanece texto por padrão. Canais que intencionalmente mapeiam respostas de imagem em Markdown para anexos de mídia aderem a isso no adaptador de saída; o Telegram faz isso para que ![alt](url) ainda possa se tornar uma resposta de mídia. Essas diretivas são separadas. Campos de mídia estruturados e tags de resposta/voz são metadados de entrega; [embed ...] é o caminho de renderização rica exclusivo da web. Quando o streaming de blocos está habilitado, a mídia deve ser carregada em campos de payload estruturados. Se a mesma URL de mídia for enviada em um bloco em streaming e repetida no payload final do assistente, o OpenClaw entrega o anexo uma vez e remove a duplicata do payload final.

​
[embed ...]

[embed ...] é a única sintaxe de renderização rica voltada para agentes para a Control UI. Exemplo de autofechamento: 
[embed ref="cv_123" title="Status" /]
Regras:
  • [view ...] não é mais válido para novas saídas.
  • Shortcodes de embed são renderizados apenas na superfície de mensagem do assistente.
  • Apenas embeds baseados em URL são renderizados. Use ref="..." ou url="...".
  • Shortcodes de embed de HTML inline em forma de bloco não são renderizados.
  • A interface web remove o shortcode do texto visível e renderiza o embed inline.
  • Mídia estruturada não é um alias de embed e não deve ser usada para renderização de embed rico.

​
Formato de renderização armazenado

O bloco de conteúdo do assistente normalizado/armazenado é um item canvas estruturado: 
{
  "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
  }
}
Blocos ricos armazenados/renderizados usam esse formato canvas diretamente. present_view não é reconhecido.

​
Relacionados