// dokumentacja openclaw

Pętla agenta w OpenClaw — cykl wykonania krok po kroku

Czym jest pętla agenta?

Pętla agenta (Agent Loop) to kompletny cykl wykonania w OpenClaw. Obejmuje kolejne etapy: przyjęcie wiadomości, złożenie kontekstu, wnioskowanie modelu AI, wykonanie narzędzi, strumieniowanie odpowiedzi i utrwalenie stanu. Przez cały cykl utrzymywana jest spójność stanu sesji.

Przebieg procesu — krok po kroku

Przepływ obejmuje kilka sekwencyjnych etapów:

  1. Walidacja wejścia — wywołanie RPC agent waliduje parametry, rozwiązuje sesję i natychmiast zwraca { runId, acceptedAt }.
  2. Wykonanie polecenia agenta — system rozwiązuje ustawienia modelu, ładuje umiejętności (skills) i wywołuje rdzeń runtime'u pi-agent-core, emitując zdarzenia cyklu życia.
  3. Uruchomienie wbudowanego agenta Pi — wykonanie jest serializowane za pomocą kolejek per-sesja. System buduje sesję Pi, subskrybuje zdarzenia, egzekwuje limity czasowe i zwraca dane wraz z informacjami o zużyciu zasobów.
  4. Mostek zdarzeń — zdarzenia narzędzi mapowane są na strumień tool, delty asystenta na strumień assistant, a zdarzenia cyklu życia na strumień lifecycle ze wskaźnikami faz.
  5. Oczekiwanie na zakończenie — funkcja agent.wait czeka na zdarzenie końca lub błędu dla danego runId i zwraca status wraz z metadanymi czasowymi.

Kontrola współbieżności

Uruchomienia serializowane są per-sesja, a opcjonalnie także przez globalne pasy (lanes), co zapobiega konfliktom narzędzi i sesji. Dzięki temu dwa równoległe zapytania do tego samego agenta nie wchodzą sobie w drogę.

Składanie promptu systemowego

Prompt systemowy budowany jest z kilku warstw: bazowego promptu, promptu umiejętności, kontekstu bootstrap oraz nadpisań per-uruchomienie. Limity tokenów specyficzne dla modelu są ściśle egzekwowane, aby kontekst mieścił się w oknie modelu.

System hooków

OpenClaw oferuje dwie warstwy przechwytywania:

  • Hooki Gateway — skrypty sterowane zdarzeniami, uruchamiane na poziomie bramy
  • Hooki wtyczek — punkty rozszerzenia cyklu życia agenta i narzędzi

Strumieniowanie odpowiedzi

Delty asystenta strumieniowane są z rdzenia pi-agent-core. Strumieniowanie bloków i strumieniowanie rozumowania można konfigurować niezależnie, dając pełną kontrolę nad sposobem dostarczania odpowiedzi użytkownikowi.

Konfiguracja limitów czasowych

Domyślny limit czasu agenta to 48 godzin. Limit bezczynności LLM wynosi 60 sekund, chyba że zostanie jawnie ustawiony inaczej. Wartości te można dostosować w konfiguracji.

Punkty wejścia

  • Gateway RPC: metody agent i agent.wait
  • CLI: polecenie agent
Wróc do dokumentacji