Skip to main content

Kontekst

„Kontekst” to wszystko, co OpenClaw wysyła do modelu na potrzeby pojedynczego uruchomienia. Jest on ograniczony oknem kontekstu modelu (limitem tokenów). Intuicyjny model dla początkujących:
  • Prompt systemowy (zbudowany przez OpenClaw): reguły, narzędzia, lista Skills, czas/środowisko uruchomieniowe oraz wstrzyknięte pliki obszaru roboczego.
  • Historia rozmowy: Twoje wiadomości + odpowiedzi asystenta w tej sesji.
  • Wywołania narzędzi/wyniki + załączniki: wyjścia poleceń, odczyty plików, obrazy/audio itp.
Kontekst nie jest tym samym co „pamięć”: pamięć może być zapisana na dysku i wczytana później; kontekst to to, co mieści się w bieżącym oknie modelu.

Szybki start (inspekcja kontekstu)

  • /status → szybki widok „jak bardzo zapełnione jest moje okno?” + ustawienia sesji.
  • /context list → co jest wstrzykiwane + przybliżone rozmiary (na plik + sumy).
  • /context detail → głębszy podział: rozmiary na plik, rozmiary schematów narzędzi, rozmiary wpisów Skills oraz rozmiar promptu systemowego.
  • /usage tokens → dołącza stopkę użycia na odpowiedź do zwykłych odpowiedzi.
  • /compact → streszcza starszą historię do zwartego wpisu, aby zwolnić miejsce w oknie.
Zobacz także: Polecenia ukośnikowe, Użycie tokenów i koszty, Kompakcja.

Przykładowe wyjście

Wartości różnią się w zależności od modelu, dostawcy, polityki narzędzi i zawartości obszaru roboczego.

/context list

/context detail

Co wlicza się do okna kontekstu

Liczy się wszystko, co otrzymuje model, w tym:
  • Prompt systemowy (wszystkie sekcje).
  • Historia rozmowy.
  • Wywołania narzędzi + wyniki narzędzi.
  • Załączniki/transkrypty (obrazy/audio/pliki).
  • Podsumowania kompakcji i artefakty przycinania.
  • „Opakowania” dostawcy lub ukryte nagłówki (niewidoczne, ale liczone).

Jak OpenClaw buduje prompt systemowy

Prompt systemowy jest własnością OpenClaw i jest przebudowywany przy każdym uruchomieniu. Zawiera:
  • Listę narzędzi + krótkie opisy.
  • Listę Skills (tylko metadane; patrz poniżej).
  • Lokalizację obszaru roboczego.
  • Czas (UTC + przeliczony czas użytkownika, jeśli skonfigurowano).
  • Metadane środowiska uruchomieniowego (host/OS/model/myślenie).
  • Wstrzyknięte pliki bootstrapowe obszaru roboczego w sekcji Project Context.
Pełny podział: Prompt systemowy.

Wstrzyknięte pliki obszaru roboczego (Project Context)

Domyślnie OpenClaw wstrzykuje stały zestaw plików obszaru roboczego (jeśli są obecne):
  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md (tylko przy pierwszym uruchomieniu)
Duże pliki są obcinane per plik przy użyciu agents.defaults.bootstrapMaxChars (domyślnie 20000 znaków). OpenClaw egzekwuje również łączny limit wstrzykiwania bootstrap we wszystkich plikach za pomocą agents.defaults.bootstrapTotalMaxChars (domyślnie 24000 znaków). /context pokazuje rozmiary surowe vs wstrzyknięte oraz informuje, czy nastąpiło obcięcie.

Skills: co jest wstrzykiwane, a co ładowane na żądanie

Prompt systemowy zawiera zwartą listę Skills (nazwa + opis + lokalizacja). Ta lista generuje realny narzut. Instrukcje Skills nie są dołączane domyślnie. Oczekuje się, że model read SKILL.md danej umiejętności tylko wtedy, gdy jest potrzebna.

Narzędzia: są dwa koszty

Narzędzia wpływają na kontekst na dwa sposoby:
  1. Tekst listy narzędzi w promptcie systemowym (to, co widzisz jako „Tooling”).
  2. Schematy narzędzi (JSON). Są wysyłane do modelu, aby mógł wywoływać narzędzia. Wliczają się do kontekstu, mimo że nie widzisz ich jako zwykłego tekstu.
/context detail rozbija największe schematy narzędzi, aby pokazać, co dominuje.

Polecenia, dyrektywy i „skrótowce inline”

Polecenia ukośnikowe są obsługiwane przez Gateway. Istnieje kilka zachowań:
  • Polecenia samodzielne: wiadomość, która składa się wyłącznie z /..., jest uruchamiana jako polecenie.
  • Dyrektywy: /think, /verbose, /reasoning, /elevated, /model, /queue są usuwane, zanim model zobaczy wiadomość.
    • Wiadomości zawierające wyłącznie dyrektywy utrwalają ustawienia sesji.
    • Dyrektywy inline w zwykłej wiadomości działają jako wskazówki per wiadomość.
  • Skrótowce inline (tylko dla nadawców z listy dozwolonych): określone tokeny /... wewnątrz zwykłej wiadomości mogą uruchomić się natychmiast (np. „hej /status”) i są usuwane, zanim model zobaczy pozostały tekst.
Szczegóły: Polecenia ukośnikowe.

Sesje, kompakcja i przycinanie (co się utrwala)

To, co utrzymuje się między wiadomościami, zależy od mechanizmu:
  • Zwykła historia utrzymuje się w transkrypcie sesji, dopóki nie zostanie skompaktowana/przycięta przez politykę.
  • Kompakcja utrwala podsumowanie w transkrypcie i zachowuje nienaruszone najnowsze wiadomości.
  • Przycinanie usuwa stare wyniki narzędzi z promptu w pamięci dla danego uruchomienia, ale nie przepisuje transkryptu.
Dokumentacja: Sesja, Kompakcja, Przycinanie sesji.

Co /context faktycznie raportuje

/context preferuje najnowszy raport promptu systemowego zbudowany podczas uruchomienia, gdy jest dostępny:
  • System prompt (run) = przechwycony z ostatniego uruchomienia osadzonego (z obsługą narzędzi) i utrwalony w magazynie sesji.
  • System prompt (estimate) = obliczany w locie, gdy nie istnieje raport z uruchomienia (albo gdy uruchamiasz przez backend CLI, który nie generuje raportu).
W obu przypadkach raportuje rozmiary i główne czynniki; nie zrzuca pełnego promptu systemowego ani schematów narzędzi.