Skip to main content
Вывод ассистента передаёт директивы доставки и отображения через несколько специализированных каналов:
  • Структурированные поля mediaUrl / mediaUrls для доставки вложений.
  • [[audio_as_voice]] для указаний по представлению аудио.
  • [[reply_to_current]] / [[reply_to:<id>]] для метаданных ответа.
  • [embed ...] для расширенного отображения в интерфейсе управления.
Структурированные поля мультимедиа и теги [[...]] являются метаданными доставки. [embed ...] — это отдельный путь расширенного отображения только для веб-интерфейса, а не псевдоним мультимедиа.

​
Мультимедийные вложения

Удалённые вложения должны быть общедоступными URL-адресами https:. Имена узлов http:, обратной связи, локального канала, частной и внутренней сети отклоняются в директивах вложений; серверные средства получения мультимедиа дополнительно применяют собственные сетевые ограничения. Для локальных вложений допустимы абсолютные пути, пути относительно рабочей области и пути ~/ относительно домашнего каталога. Перед доставкой они по-прежнему проходят проверку политикой чтения файлов агента и проверку типа мультимедиа.
Не выводите текстовые команды для вложений из инструментов, плагинов, потоковых блоков, вывода браузера или действий с сообщениями. Вместо этого используйте структурированные поля мультимедиа:
Текст устаревшего финального ответа всё ещё может нормализоваться для совместимости, но это не общий протокол плагинов или инструментов.
Обычный синтаксис изображений Markdown (![alt](url)) по умолчанию остаётся текстом. Каналы, которым требуется обрабатывать изображения Markdown как ответы с мультимедиа, включают это в своём адаптере исходящих сообщений; Telegram делает это, поэтому ![alt](url) становится мультимедийным вложением. Когда включена потоковая передача блоков, мультимедиа должны передаваться в структурированных полях полезной нагрузки. Если один и тот же URL-адрес мультимедиа присутствует в потоковом блоке и снова в финальной полезной нагрузке ассистента, OpenClaw доставляет его один раз и удаляет дубликат из финальной полезной нагрузки.

​
[embed ...]

[embed ...] — единственный доступный агенту синтаксис расширенного отображения для интерфейса управления. Пример с самозакрывающимся элементом:
Правила:
  • [view ...] больше не допустим для нового вывода.
  • Шорткоды встраивания отображаются только в области сообщений ассистента.
  • Отображаются только встраиваемые элементы на основе URL-адресов; используйте ref="..." или url="...".
  • Блочные шорткоды встраивания со встроенным HTML не отображаются.
  • Веб-интерфейс удаляет шорткод из видимого текста и отображает встроенный элемент непосредственно в сообщении.

​
Формат хранения и отображения

Нормализованный и сохранённый блок содержимого ассистента представляет собой структурированный элемент canvas:
present_view не распознаётся; сохранённые и отображаемые расширенные блоки всегда используют этот формат canvas.

​
Связанные материалы