OpenClaw timeouty: jak zatrzymywać agenta bez utraty wyniku
Najbezpieczniejszy timeout w OpenClaw nie kończy się na przerwaniu procesu. Agent powinien przed upływem limitu zapisać checkpoint, oznaczyć status i zostawić jasną instrukcję wznowienia. Dzięki temu cron nie uruchomi ślepej kopii zadania, a człowiek wie, co faktycznie się wydarzyło.
Co powinien zawierać timeout
Ustal trzy niezależne limity: czas całego zadania, czas pojedynczego kroku oraz czas oczekiwania na zewnętrzną usługę. Każdy limit powinien prowadzić do tego samego bezpiecznego zakończenia: zapisania stanu i komunikatu dla kolejnego wykonania.
- deadline — absolutny termin zakończenia zadania,
- checkpoint — ostatni ukończony krok i dane potrzebne do kontynuacji,
- status — na przykład
completed,pausedalbofailed, - next_action — jedna konkretna czynność dla następnego agenta lub człowieka.
Prosty wzorzec obsługi
Przed każdym kosztownym krokiem sprawdź, ile czasu zostało do deadline. Po udanym kroku natychmiast aktualizuj checkpoint. Gdy limit jest blisko, nie zaczynaj nowej operacji — zapisz stan i zakończ jako paused.
Przykładowy rekord stanu
Stan może być zwykłym plikiem JSON lub wpisem w bazie:
{"status":"paused","completed_steps":["pobranie_danych","walidacja"],"next_action":"wyslij_raport","updated_at":"2026-10-18T08:00:00Z"}
W praktyce ważniejsze od nazwy pól jest to, aby kolejny wykonawca mógł odtworzyć decyzję bez czytania całych logów.
Jak uniknąć podwójnego wykonania
Każdy krok powinien mieć stabilny identyfikator. Przed wysłaniem raportu sprawdź, czy dla tego identyfikatora istnieje już status completed. Jeśli tak, pomiń wysyłkę i przejdź do kolejnego kroku. To łączy timeout z idempotencją i chroni przed ponowieniem crona.
- zapisuj identyfikator zadania razem z checkpointem,
- oddziel status kroku od statusu całego workflowu,
- po wznowieniu najpierw odczytaj stan, dopiero potem wykonuj akcje,
- loguj powód zatrzymania: deadline, błąd usługi albo ręczna pauza.
Test przed wdrożeniem
Uruchom zadanie z bardzo krótkim limitem i wymuś zatrzymanie w każdym ważnym kroku. Sprawdź, czy wznowienie nie powtarza wysłanych powiadomień, czy status jest jednoznaczny i czy cron potrafi odróżnić paused od failed. Dopiero potem ustaw realny limit.
Ograniczenia tego wzorca
Checkpoint nie cofnie operacji, która już zmieniła system zewnętrzny. Dla płatności, wiadomości i zmian w API potrzebujesz dodatkowo klucza idempotencji albo ręcznej kontroli. Timeout nie zastępuje monitoringu: nadal mierz czas kroków i alarmuj o zbyt wielu wznowieniach.
FAQ
Czy timeout powinien zabijać agenta natychmiast?
Nie, jeśli możesz zostawić stan. Najpierw wykonaj krótki etap zamknięcia i zapisz checkpoint; twarde przerwanie traktuj jako awarię wymagającą odtworzenia z logów.
Gdzie trzymać checkpoint?
W miejscu trwałym i dostępnym dla kolejnego wykonania: w pliku roboczym, bazie albo magazynie z wersjonowaniem. Nie trzymaj jedynej kopii wyłącznie w pamięci procesu.
Jak zacząć?
Dodaj deadline, status i next_action do jednego małego rekordu. Następnie dopisz test wznowienia po każdym kroku.
Jeśli chcesz uporządkować całą automatyzację, zacznij od dokumentacji OpenClaw i wdrażaj ten wzorzec na jednym cronowym workflowie.