// dokumentacja openclaw

Prompt systemowy w OpenClaw — dynamiczne składanie instrukcji

Przegląd

OpenClaw konstruuje unikatowy prompt systemowy dla każdego uruchomienia agenta. Framework składa go dynamicznie i wstrzykuje podczas runtime'u — nie polega na domyślnych szablonach.

Personalizacja przez wtyczki providerów

Wtyczki providerów mogą wprowadzać ukierunkowane modyfikacje bez zastępowania całego promptu:

  • Dostosowanie nazwanych sekcji: interaction_style, tool_call_style, execution_bias
  • Wstrzyknięcie stabilnego prefiksu powyżej granicy prompt cache
  • Wstrzyknięcie dynamicznego sufiksu poniżej granicy prompt cache

Hook before_prompt_build jest zarezerwowany dla kompatybilności wstecznej lub naprawdę globalnych zmian.

Struktura promptu

Prompt utrzymuje celową zwartość i składa się z następujących stałych sekcji:

  • Tooling — referencja narzędzi strukturalnych i wskazówki runtime
  • Safety — zabezpieczenia przed dążeniem do władzy i omijaniem nadzoru
  • Skills — instrukcje ładowania plików umiejętności na żądanie
  • OpenClaw Self-Update — bezpieczna inspekcja i patchowanie konfiguracji
  • Workspace — referencja katalogu roboczego
  • Documentation — ścieżka do lokalnych dokumentów i wskazówki użycia
  • Workspace Files — wskaźniki plików bootstrap
  • Sandbox — szczegóły środowiska runtime gdy włączony
  • Current Date & Time — kontekst czasowy użytkownika
  • Reply Tags — opcjonalna składnia dla wspieranych providerów
  • Heartbeats — status monitoringu w tle
  • Runtime — host, OS, model, informacje o repozytorium
  • Reasoning — poziom widoczności i wskazówki przełączania

Tryby renderowania promptu

Trzy tryby dostosowane do kontekstu:

  1. full — domyślny; zawiera wszystkie sekcje
  2. minimal — dla subagentów; pomija Skills, Memory Recall, Self-Update i powiązane sekcje
  3. none — zwraca jedynie linię bazowej tożsamości

Wstrzykiwanie plików bootstrap

Następujące pliki są automatycznie wstrzykiwane do kontekstu przy każdej turze:

AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md

Pliki obcinane są przy przekroczeniu bootstrapMaxChars (domyślnie 20 000 znaków). Łączna wielkość wstrzykiwanej treści ograniczona jest do bootstrapTotalMaxChars (domyślnie 150 000 znaków).

Obsługa czasu

Prompt zawiera sekcję z datą i godziną, gdy znana jest strefa czasowa użytkownika. Referencja obejmuje wyłącznie strefę (dla stabilności cache'u), a agenty powinny używać session_status do pobrania bieżącego czasu.