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.

Przycinanie sesji przycina stare wyniki narzędzi z kontekstu przed każdym wywołaniem LLM. Ogranicza rozrost kontekstu spowodowany nagromadzonymi wynikami narzędzi (wyniki exec, odczyty plików, wyniki wyszukiwania), bez przepisywania zwykłego tekstu rozmowy.
Przycinanie działa tylko w pamięci — nie modyfikuje transkryptu sesji na dysku. Pełna historia jest zawsze zachowywana.

​
Dlaczego to ma znaczenie

Długie sesje gromadzą wyniki narzędzi, które powiększają okno kontekstu. To zwiększa koszty i może wymusić Compaction wcześniej, niż jest to konieczne. Przycinanie jest szczególnie wartościowe dla pamięci podręcznej promptów Anthropic. Po wygaśnięciu TTL pamięci podręcznej następne żądanie ponownie zapisuje w cache cały prompt. Przycinanie zmniejsza rozmiar zapisu do cache, bezpośrednio obniżając koszt.

​
Jak to działa

  1. Poczekaj na wygaśnięcie TTL cache (domyślnie 5 minut).
  2. Znajdź stare wyniki narzędzi do zwykłego przycinania (tekst rozmowy pozostaje bez zmian).
  3. Miękkie przycięcie zbyt dużych wyników — zachowaj początek i koniec, wstaw ....
  4. Twarde wyczyszczenie pozostałych — zastąp placeholderem.
  5. Zresetuj TTL, aby kolejne żądania korzystały ze świeżego cache.

​
Czyszczenie starszych obrazów

OpenClaw buduje też osobny idempotentny widok odtwarzania dla sesji, które zachowują surowe bloki obrazów lub znaczniki mediów z hydracji promptu w historii.
  • Zachowuje 3 najnowsze ukończone tury bajt w bajt, aby prefiksy pamięci podręcznej promptu dla ostatnich działań następczych pozostały stabilne.
  • W widoku odtwarzania starsze już przetworzone bloki obrazów z historii user lub toolResult mogą zostać zastąpione przez [image data removed - already processed by model].
  • Starsze tekstowe odwołania do mediów, takie jak [media attached: ...], [Image: source: ...] i media://inbound/..., mogą zostać zastąpione przez [media reference removed - already processed by model]. Znaczniki załączników bieżącej tury pozostają nienaruszone, aby modele vision nadal mogły hydratuować nowe obrazy.
  • Surowy transkrypt sesji nie jest przepisywany, więc przeglądarki historii nadal mogą renderować oryginalne wpisy wiadomości i ich obrazy.
  • To rozwiązanie jest oddzielne od zwykłego przycinania według TTL cache. Istnieje po to, by zatrzymać powtarzające się ładunki obrazów lub nieaktualne odwołania do mediów przed psuciem pamięci podręcznej promptów w późniejszych turach.

​
Inteligentne wartości domyślne

OpenClaw automatycznie włącza przycinanie dla profili Anthropic:
Typ profiluPrzycinanie włączoneHeartbeat
Uwierzytelnianie Anthropic OAuth/token (w tym ponowne użycie Claude CLI)Tak1 godzina
Klucz APITak30 min
Jeśli ustawisz jawne wartości, OpenClaw ich nie nadpisze.

​
Włączanie lub wyłączanie

Przycinanie jest domyślnie wyłączone dla dostawców innych niż Anthropic. Aby je włączyć: 
{
  agents: {
    defaults: {
      contextPruning: { mode: "cache-ttl", ttl: "5m" },
    },
  },
}
Aby wyłączyć: ustaw mode: "off".

​
Przycinanie a Compaction

PrzycinanieCompaction
CoPrzycina wyniki narzędziStreszcza rozmowę
Zapisywane?Nie (na żądanie)Tak (w transkrypcie)
ZakresTylko wyniki narzędziCała rozmowa
Uzupełniają się nawzajem — przycinanie utrzymuje lekkie wyniki narzędzi pomiędzy cyklami Compaction.

​
Dalsza lektura

  • Compaction — redukcja kontekstu oparta na streszczaniu
  • Konfiguracja Gateway — wszystkie ustawienia konfiguracyjne przycinania (contextPruning.*)

​
Powiązane