> ## 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.

# Pokaż widżet

`show_widget` renderuje samodzielny fragment SVG lub HTML bezpośrednio w transkrypcji czatu interfejsu Control UI. Dołączony Plugin Canvas jest właścicielem narzędzia i udostępnia każdy wynik jako dokument Canvas z tego samego źródła.

Narzędzie jest dostępne tylko wtedy, gdy źródłowy klient Gateway deklaruje możliwość `inline-widgets`. Interfejs Control UI deklaruje ją automatycznie. Uruchomienia w kanałach takich jak Telegram i WhatsApp nie otrzymują narzędzia `show_widget`.

Przekazywanie możliwości obejmuje osadzone zaplecza modeli, zaplecza korzystające z serwera aplikacji Codex oraz zaplecza oparte na CLI. Wywołania MCP uwierzytelniane przyznanym dostępem oraz bezpośrednie wywołania narzędzi przez HTTP pozostają domyślnie blokowane, ponieważ nie deklarują możliwości klienta.

## Używanie narzędzia

Agent przekazuje dwa wymagane ciągi znaków:

<ParamField path="title" type="string" required>
  Krótki tytuł wyświetlany przy podglądzie osadzonym oraz jako tytuł udostępnionego dokumentu.
</ParamField>

<ParamField path="widget_code" type="string" required>
  Samodzielny fragment SVG lub HTML. Dane wejściowe rozpoczynające się od `<svg` po usunięciu skrajnych białych znaków są renderowane w trybie SVG; wszystkie pozostałe dane wejściowe są traktowane jako fragment HTML. Maksymalna długość: 262 144 znaki.
</ParamField>

Wynik narzędzia zawiera uchwyt podglądu Canvas, dzięki czemu czat internetowy renderuje widżet bezpośrednio na podstawie wywołania narzędzia i przywraca go po ponownym wczytaniu historii. Transkrypcje, które nie renderują podglądów, nadal wyświetlają ścieżkę udostępnionego dokumentu Canvas.

## Bezpieczeństwo i przechowywanie

Dokumenty widżetów korzystają z restrykcyjnych zasad Content Security Policy: wbudowane style i skrypty są dozwolone, obrazy mogą używać adresów URL `data:`, a zewnętrzne pobieranie danych i ładowanie zasobów są zablokowane. Cały kod znaczników, style, skrypty i dane obrazów należy umieścić w `widget_code`.

Element iframe zawsze pomija `allow-same-origin`, nawet gdy globalny tryb osadzania interfejsu Control UI ma wartość `trusted`, dlatego skrypty widżetu nie mogą odczytać źródła aplikacji nadrzędnej. Host Canvas udostępnia również dokumenty widżetów z nagłówkiem odpowiedzi `Content-Security-Policy: sandbox allow-scripts`, dzięki czemu bezpośrednie otwarcie udostępnionego adresu URL nadal uruchamia widżet w nieprzezroczystym źródle zamiast w źródle interfejsu Control UI. Mechanizmy izolacji przeglądarki nie uniemożliwiają skryptowi nawigowania we własnym elemencie iframe; renderuj wyłącznie kod widżetu, który akceptujesz do wykonania w tej odizolowanej ramce.

Element iframe stosuje się również do ustawienia [`gateway.controlUi.embedSandbox`](/pl/web/control-ui#hosted-embeds). Domyślny poziom `scripts` obsługuje interaktywne widżety, zachowując izolację źródła.

Canvas przechowuje maksymalnie 32 widżety na sesję (lub na agenta, gdy sesja jest niedostępna). Utworzenie kolejnego widżetu usuwa najstarszy dokument w tym zakresie.

## Powiązane materiały

* [Osadzona zawartość udostępniana przez Control UI](/pl/web/control-ui#hosted-embeds)
* [Plugin Canvas](/pl/plugins/reference/canvas)
* [Możliwości klienta protokołu Gateway](/pl/gateway/protocol#client-capabilities)