Kontekst

„Kontekst” to wszystko, co OpenClaw wysyła do modelu na potrzeby uruchomienia. Jest ograniczony przez okno kontekstu modelu (limit tokenów).

Model mentalny dla początkujących:

• Prompt systemowy (zbudowany przez OpenClaw): reguły, narzędzia, lista Skills, czas/środowisko wykonawcze oraz wstrzyknięte pliki obszaru roboczego.
• Historia rozmowy: Twoje wiadomości + wiadomości asystenta w tej sesji.
• Wywołania/wyniki narzędzi + załączniki: wynik polecenia, odczyty plików, obrazy/audio itd.

Kontekst to nie to samo co „pamięć”: pamięć może być zapisana na dysku i wczytana ponownie później; kontekst to to, co znajduje się w bieżącym oknie modelu.

# Szybki start (sprawdzanie kontekstu)

• /status → szybki widok „jak pełne jest moje okno?” + ustawienia sesji.
• /context list → co jest wstrzyknięte + przybliżone rozmiary (dla pliku + sumy).
• /context detail → głębszy podział: rozmiary dla plików, schematów narzędzi, wpisów Skills oraz rozmiar promptu systemowego.
• /usage tokens → dołącz stopkę użycia dla każdej odpowiedzi do zwykłych odpowiedzi.
• /compact → podsumuj starszą historię w kompaktowy wpis, aby zwolnić miejsce w oknie.

Zobacz też: Polecenia z ukośnikiem, Użycie tokenów i koszty, Compaction.

# Przykładowy wynik

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

# /context list

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 12,000 chars
Sandbox: mode=non-main sandboxed=false
System prompt (run): 38,412 chars (~9,603 tok) (Project Context 23,901 chars (~5,976 tok))

Injected workspace files:
- AGENTS.md: OK | raw 1,742 chars (~436 tok) | injected 1,742 chars (~436 tok)
- SOUL.md: OK | raw 912 chars (~228 tok) | injected 912 chars (~228 tok)
- TOOLS.md: TRUNCATED | raw 54,210 chars (~13,553 tok) | injected 20,962 chars (~5,241 tok)
- IDENTITY.md: OK | raw 211 chars (~53 tok) | injected 211 chars (~53 tok)
- USER.md: OK | raw 388 chars (~97 tok) | injected 388 chars (~97 tok)
- HEARTBEAT.md: MISSING | raw 0 | injected 0
- BOOTSTRAP.md: OK | raw 0 chars (~0 tok) | injected 0 chars (~0 tok)

Skills list (system prompt text): 2,184 chars (~546 tok) (12 skills)
Tools: read, edit, write, exec, process, browser, message, sessions_send, …
Tool list (system prompt text): 1,032 chars (~258 tok)
Tool schemas (JSON): 31,988 chars (~7,997 tok) (counts toward context; not shown as text)
Tools: (same as above)

Session tokens (cached): 14,250 total / ctx=32,000

# /context detail

🧠 Context breakdown (detailed)
…
Top skills (prompt entry size):
- frontend-design: 412 chars (~103 tok)
- oracle: 401 chars (~101 tok)
… (+10 more skills)

Top tools (schema size):
- browser: 9,812 chars (~2,453 tok)
- exec: 6,240 chars (~1,560 tok)
… (+N more tools)

# Co wlicza się do okna kontekstu

Wlicza 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 Compaction i artefakty przycinania.
• „Opakowania” dostawcy lub ukryte nagłówki (niewidoczne, ale nadal liczone).

# Jak OpenClaw buduje prompt systemowy

Prompt systemowy jest własnością OpenClaw i jest przebudowywany przy każdym uruchomieniu. Obejmuje:

• Listę narzędzi + krótkie opisy.
• Listę Skills (tylko metadane; zobacz niżej).
• Lokalizację obszaru roboczego.
• Czas (UTC + przeliczony czas użytkownika, jeśli skonfigurowano).
• Metadane środowiska wykonawczego (host/OS/model/myślenie).
• Wstrzyknięte pliki startowe obszaru roboczego w sekcji Kontekst projektu.

Pełny podział: Prompt systemowy.

# Wstrzyknięte pliki obszaru roboczego (Kontekst projektu)

Domyślnie OpenClaw wstrzykuje stały zestaw plików obszaru roboczego (jeśli istnieją):

• AGENTS.md
• SOUL.md
• TOOLS.md
• IDENTITY.md
• USER.md
• HEARTBEAT.md
• BOOTSTRAP.md (tylko przy pierwszym uruchomieniu)

Duże pliki są obcinane osobno dla każdego pliku przy użyciu agents.defaults.bootstrapMaxChars (domyślnie 12000 znaków). OpenClaw wymusza też łączny limit wstrzyknięcia startowego dla wszystkich plików za pomocą agents.defaults.bootstrapTotalMaxChars (domyślnie 60000 znaków). /context pokazuje rozmiary surowe i wstrzyknięte oraz informację, czy nastąpiło obcięcie.

Gdy wystąpi obcięcie, środowisko wykonawcze może wstrzyknąć blok ostrzeżenia w prompcie w sekcji Kontekst projektu. Skonfiguruj to za pomocą agents.defaults.bootstrapPromptTruncationWarning (off, once, always; domyślnie once).

# Skills: wstrzyknięte a ładowane na żądanie

Prompt systemowy zawiera zwartą listę Skills (nazwa + opis + lokalizacja). Ta lista ma rzeczywisty narzut.

Instrukcje Skill nie są domyślnie dołączane. Oczekuje się, że model read plik SKILL.md danej Skill tylko wtedy, gdy jest potrzebny.

# Narzędzia: istnieją dwa koszty

Narzędzia wpływają na kontekst na dwa sposoby:

1. Tekst listy narzędzi w prompcie systemowym (to, co widzisz jako „Narzędzia”).
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óty w treści”

Polecenia z ukośnikiem są obsługiwane przez Gateway. Istnieje kilka różnych zachowań:

• Samodzielne polecenia: wiadomość, która zawiera tylko /..., uruchamia się jako polecenie.
• Dyrektywy: /think, /verbose, /trace, /reasoning, /elevated, /model, /queue są usuwane, zanim model zobaczy wiadomość.
  • Wiadomości zawierające wyłącznie dyrektywy utrwalają ustawienia sesji.
  • Dyrektywy w treści zwykłej wiadomości działają jako wskazówki dla tej wiadomości.
• Skróty w treści (tylko nadawcy z listy dozwolonych): niektóre tokeny /... wewnątrz zwykłej wiadomości mogą uruchomić się natychmiast (przykład: „hej /status”) i są usuwane, zanim model zobaczy pozostały tekst.

Szczegóły: Polecenia z ukośnikiem.

# Sesje, Compaction i przycinanie (co jest zachowywane)

To, co jest zachowywane między wiadomościami, zależy od mechanizmu:

• Zwykła historia jest zachowywana w transkrypcie sesji, dopóki nie zostanie poddana Compaction/przycięta zgodnie z zasadami.
• Compaction zapisuje podsumowanie w transkrypcie i pozostawia ostatnie wiadomości bez zmian.
• Przycinanie usuwa stare wyniki narzędzi z promptu w pamięci, aby zwolnić miejsce w oknie kontekstu, ale nie przepisuje transkryptu sesji - pełna historia nadal jest dostępna do sprawdzenia na dysku.

Dokumentacja: Sesja, Compaction, Przycinanie sesji.

Domyślnie OpenClaw używa wbudowanego silnika kontekstu legacy do składania i Compaction. Jeśli zainstalujesz Plugin, który udostępnia kind: "context-engine", i wybierzesz go za pomocą plugins.slots.contextEngine, OpenClaw przekaże składanie kontekstu, /compact oraz powiązane haki cyklu życia kontekstu subagenta temu silnikowi. ownsCompaction: false nie powoduje automatycznego powrotu do silnika legacy; aktywny silnik nadal musi poprawnie implementować compact(). Zobacz Silnik kontekstu, aby poznać pełny interfejs wtyczkowy, haki cyklu życia i konfigurację.

# Co faktycznie raportuje /context

/context preferuje najnowszy raport promptu systemowego zbudowany podczas uruchomienia, jeśli jest dostępny:

• System prompt (run) = przechwycony z ostatniego osadzonego uruchomienia (obsługującego narzędzia) i zapisany w magazynie sesji.
• System prompt (estimate) = obliczany w locie, gdy nie istnieje raport uruchomienia (albo gdy działa przez backend CLI, który nie generuje raportu).

W obu przypadkach raportuje rozmiary i najważniejszych kontrybutorów; nie zrzuca pełnego promptu systemowego ani schematów narzędzi.

# Powiązane