Protokół rozszerzonego wyjścia

Dane wyjściowe asystenta przekazują dyrektywy dostarczania/renderowania za pośrednictwem kilku dedykowanych kanałów:

Ustrukturyzowane pola mediaUrl / mediaUrls do dostarczania załączników.
[[audio_as_voice]] dla wskazówek dotyczących prezentacji dźwięku.
[[reply_to_current]] / [[reply_to:<id>]] dla metadanych odpowiedzi.
[embed ...] do rozszerzonego renderowania w interfejsie Control UI.

Ustrukturyzowane pola multimediów oraz znaczniki [[...]] stanowią metadane dostarczania. [embed ...] jest osobną, dostępną wyłącznie w interfejsie internetowym ścieżką rozszerzonego renderowania; nie jest aliasem multimediów.

Załączniki multimedialne

Załączniki zdalne muszą być publicznymi adresami URL https:. Adresy http:, local loopback i link-local oraz prywatne i wewnętrzne nazwy hostów są odrzucane jako dyrektywy załączników; mechanizmy pobierania multimediów po stronie serwera stosują dodatkowo własne zabezpieczenia sieciowe. Załączniki lokalne mogą używać ścieżek bezwzględnych, ścieżek względnych wobec obszaru roboczego lub ścieżek ~/ względnych wobec katalogu domowego. Przed dostarczeniem nadal podlegają zasadom odczytu plików przez agenta oraz kontroli typu multimediów.

Nie emituj tekstowych poleceń dotyczących załączników z narzędzi, pluginów, bloków przesyłania strumieniowego, danych wyjściowych przeglądarki ani akcji wiadomości. Zamiast tego używaj ustrukturyzowanych pól multimediów:

{ "message": "Oto Twój obraz.", "mediaUrl": "/workspace/image.png" }

Tekst starszych odpowiedzi końcowych może być nadal normalizowany w celu zapewnienia zgodności, ale nie jest to ogólny protokół pluginów ani narzędzi.

Zwykła składnia obrazów Markdown (![alt](url)) domyślnie pozostaje tekstem. Kanały, które chcą traktować obrazy Markdown jako odpowiedzi multimedialne, włączają tę funkcję w swoim adapterze wychodzącym; Telegram robi to, dzięki czemu ![alt](url) staje się załącznikiem multimedialnym. Gdy włączone jest strumieniowanie blokowe, multimedia muszą być przesyłane w ustrukturyzowanych polach ładunku. Jeśli ten sam adres URL multimediów pojawi się w przesyłanym strumieniowo bloku, a następnie ponownie w końcowym ładunku asystenta, OpenClaw dostarczy go raz i usunie duplikat z końcowego ładunku.

`[embed ...]`

[embed ...] jest jedyną składnią rozszerzonego renderowania dostępną dla agenta w interfejsie Control UI. Przykład samozamykający:

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

Zasady:

[view ...] nie jest już prawidłową składnią dla nowych danych wyjściowych.
Skrócone znaczniki osadzania są renderowane wyłącznie w obszarze wiadomości asystenta.
Renderowane są wyłącznie osadzenia oparte na adresach URL; użyj ref="..." lub url="...".
Blokowe skrócone znaczniki osadzania w formacie HTML nie są renderowane.
Interfejs internetowy usuwa skrócony znacznik z widocznego tekstu i renderuje osadzenie w tekście.

Przechowywana postać renderowania

Znormalizowany/przechowywany blok treści asystenta jest ustrukturyzowanym elementem canvas:

{
  "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 nie jest rozpoznawane; przechowywane/renderowane bloki rozszerzone zawsze używają tej postaci canvas.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Protokół rozszerzonego wyjścia

Załączniki multimedialne

`[embed ...]`

Przechowywana postać renderowania

Powiązane

​Załączniki multimedialne

​[embed ...]

​Przechowywana postać renderowania

​Powiązane

Załączniki multimedialne

`[embed ...]`

Przechowywana postać renderowania

Powiązane