Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

„Kontekst” to wszystko, co OpenClaw wysyła do modelu na potrzeby uruchomienia. Jest on 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 uruchomieniowe oraz wstrzyknięte pliki obszaru roboczego.
  • Historia rozmowy: Twoje wiadomości + wiadomości asystenta w tej sesji.
  • Wywołania/wyniki narzędzi + załączniki: dane wyjściowe poleceń, odczyty plików, obrazy/audio itd.
Kontekst to nie to samo co „pamięć”: pamięć może być przechowywana na dysku i ponownie załadowana później; kontekst to to, co znajduje się w bieżącym oknie modelu.

​
Szybki start (inspekcja kontekstu)

  • /status → szybki widok „jak zapełnione jest moje okno?” + ustawienia sesji.
  • /context list → co jest wstrzyknięte + przybliżone rozmiary (dla każdego pliku + sumy).
  • /context detail → głębszy podział: rozmiary dla każdego pliku, schematów narzędzi, wpisów Skills oraz rozmiar promptu systemowego.
  • /context map → obraz mapy drzewa w stylu WinDirStat dla śledzonych składników kontekstu bieżącej sesji.
  • /usage tokens → dodaje do zwykłych odpowiedzi stopkę użycia dla każdej odpowiedzi.
  • /compact → podsumowuje starszą historię w kompaktowy wpis, aby zwolnić miejsce w oknie.
Zobacz także: Polecenia slash, Użycie tokenów i koszty, Compaction.

​
Przykładowe dane wyjściowe

Wartości różnią się zależnie od modelu, dostawcy, polityki narzędzi i 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)

​
/context map

Wysyła obraz wygenerowany z najnowszego buforowanego raportu uruchomienia. Zanim zwykła wiadomość utworzy raport uruchomienia w sesji, /context map zwraca komunikat o niedostępności zamiast renderować oszacowanie. Pole prostokąta jest proporcjonalne do śledzonych znaków promptu:
  • wstrzyknięte pliki obszaru roboczego
  • podstawowy tekst promptu systemowego
  • wpisy promptu Skills
  • schematy JSON narzędzi
/context list, /context detail i /context json nadal mogą sprawdzić oszacowanie na żądanie, gdy nie ma buforowanego raportu uruchomienia.

​
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 Compaction i artefakty przycinania.
  • „Wrappery” 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 uruchomieniowego (host/OS/model/thinking).
  • Wstrzyknięte pliki startowe 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 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 z użyciem agents.defaults.bootstrapMaxChars (domyślnie 12000 znaków). OpenClaw wymusza też łączny limit wstrzykiwania bootstrap dla wszystkich plików przy użyciu agents.defaults.bootstrapTotalMaxChars (domyślnie 60000 znaków). /context pokazuje rozmiary surowe vs wstrzyknięte oraz informację, czy nastąpiło obcięcie. Gdy nastąpi obcięcie, środowisko uruchomieniowe może wstrzyknąć blok ostrzeżenia wewnątrz promptu pod Project Context. Skonfiguruj to za pomocą agents.defaults.bootstrapPromptTruncationWarning (off, once, always; domyślnie once).

​
Skills: wstrzyknięte vs ładowane na żądanie

Prompt systemowy zawiera kompaktową listę Skills (nazwa + opis + lokalizacja). Ta lista ma rzeczywisty narzut. Instrukcje Skills nie są domyślnie uwzględniane. Oczekuje się, że model wykona read pliku SKILL.md danej Skills tylko wtedy, gdy jest potrzebny.

​
Narzędzia: są dwa koszty

Narzędzia wpływają na kontekst na dwa sposoby:
  1. Tekst listy narzędzi w prompcie 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 było widać, co dominuje.

​
Polecenia, dyrektywy i „skróty inline”

Polecenia slash 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 tylko dyrektywy utrwalają ustawienia sesji.
    • Dyrektywy inline w zwykłej wiadomości działają jako wskazówki dla pojedynczej wiadomości.
  • Skróty inline (tylko nadawcy z listy dozwolonych): określone tokeny /... wewnątrz zwykłej wiadomości mogą zostać uruchomione natychmiast (przykład: „hej /status”) i są usuwane, zanim model zobaczy pozostały tekst.
Szczegóły: Polecenia slash.

​
Sesje, Compaction i przycinanie (co jest utrwalane)

To, co utrzymuje się między wiadomościami, zależy od mechanizmu:
  • Zwykła historia utrzymuje się w transkrypcie sesji, dopóki nie zostanie objęta Compaction/przycięta przez politykę.
  • 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 inspekcji 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 subagentów do tego silnika. ownsCompaction: false nie powoduje automatycznego powrotu do silnika legacy; aktywny silnik nadal musi poprawnie implementować compact(). Zobacz Silnik kontekstu, aby poznać pełny interfejs rozszerzalny przez Plugin, haki cyklu życia i konfigurację.

​
Co /context faktycznie raportuje

/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 utrwalony w magazynie sesji.
  • System prompt (estimate) = obliczany w locie, gdy nie istnieje raport uruchomienia (lub podczas pracy przez backend CLI, który nie generuje raportu).
W obu przypadkach raportuje rozmiary i główne źródła narzutu; nie zrzuca pełnego promptu systemowego ani schematów narzędzi.

​
Powiązane

Silnik kontekstu

Niestandardowe wstrzykiwanie kontekstu przez plugins.

Compaction

Podsumowywanie długich rozmów, aby utrzymać je wewnątrz okna modelu.

Prompt systemowy

Jak budowany jest prompt systemowy i co wstrzykuje w każdej turze.

Pętla agenta

Pełny cykl wykonywania agenta od wiadomości przychodzącej do końcowej odpowiedzi.