OpenClaw: runbook awarii dla agentów AI
Najkrócej: dobry agent AI nie potrzebuje idealnego świata. Potrzebuje runbooka: jasnej listy kontroli, progów zatrzymania, zasad bezpiecznego retry i formatu raportu po awarii.
W OpenClaw runbook warto traktować jak część workflowu, a nie dokument na później. Dzięki temu cron, skill albo automatyzacja w przeglądarce mogą działać samodzielnie, ale nadal przewidywalnie.
Co powinien zawierać runbook dla agenta
Runbook to krótka instrukcja operacyjna dla sytuacji, w której coś nie idzie zgodnie z planem. Dla agentów OpenClaw szczególnie dobrze działa układ oparty o pięć elementów:
- Cel zadania: jedno zdanie, które mówi, jaki wynik jest akceptowalny.
- Warunki startu: jakie pliki, dane, sesje albo uprawnienia muszą istnieć przed działaniem.
- Bezpieczne kroki: kolejność operacji, w tym punkt zapisu wersji roboczej przed publikacją lub wysyłką.
- Stop conditions: sytuacje, w których agent ma przestać działać zamiast improwizować.
- Raport końcowy: format krótkiego podsumowania, które człowiek może szybko zweryfikować.
Praktyczny szablon do skopiowania
Poniższy schemat sprawdza się przy cronach publikacyjnych, monitoringu, triage inboxa i zadaniach administracyjnych:
- Sprawdź, czy cel jest jednoznaczny i czy nie powstanie duplikat.
- Pobierz świeże dane wejściowe zamiast zakładać, że poprzedni stan nadal obowiązuje.
- Wykonaj działanie najpierw w trybie odwracalnym: draft, preview, dry run albo lokalny plik roboczy.
- Zweryfikuj wynik automatycznie: status HTTP, obecność tytułu, poprawny encoding, brak błędnych linków.
- Dopiero po QA wykonaj krok publiczny: publikację, wysyłkę albo zmianę statusu.
- Na końcu zostaw raport z wynikiem i konkretnym adresem lub identyfikatorem.
Gdzie zapisać taki workflow w OpenClaw
Jeżeli instrukcja ma być użyta raz, wystarczy prompt w zadaniu. Jeżeli ma wracać cyklicznie, lepsze są trzy miejsca:
- Skill: gdy runbook opisuje powtarzalną umiejętność, na przykład publikację wpisu, obsługę panelu albo QA strony.
- Cron payload: gdy liczy się konkretny harmonogram i izolacja od zwykłej rozmowy.
- Daily notes lub pamięć robocza: gdy agent ma zapamiętać obserwacje z danego dnia, ale nie powinien publikować ich na zewnątrz.
Minimalne progi zatrzymania
Największa wartość runbooka pojawia się wtedy, gdy agent wie, kiedy nie wolno udawać sukcesu. Dobre stop conditions są konkretne:
- brak finalnego publicznego URL po publikacji,
- niezgodny status HTTP albo przekierowanie do logowania,
- mojibake, escaped HTML albo uszkodzone polskie znaki,
- link wewnętrzny prowadzący do błędu 404,
- operacja publiczna wymagająca zgody, której nie było w poleceniu.
Warto zapisywać takie warunki dosłownie, bez miękkich sformułowań. Agent ma wtedy prostą decyzję: naprawić, jeśli potrafi, albo zgłosić blocker.
Ograniczenia
Runbook nie zastępuje monitoringu, testów ani zdrowego ograniczania uprawnień. Nie powinien też zachęcać agenta do obchodzenia zabezpieczeń. Jego zadanie jest bardziej przyziemne: zmniejszyć liczbę niejasnych decyzji w stresującym momencie.
Najlepiej działa wtedy, gdy zawiera tylko te kroki, które naprawdę da się wykonać automatycznie. Zbyt długi runbook szybko staje się drugim systemem, który sam wymaga utrzymania.
FAQ
Czy każdy cron potrzebuje osobnego runbooka?
Nie. Proste przypomnienia mogą mieć tylko krótki warunek sukcesu. Runbook jest szczególnie ważny tam, gdzie cron publikuje, wysyła, zmienia dane albo działa na podstawie zewnętrznych stron.
Czym runbook różni się od skilla?
Skill opisuje trwałą umiejętność agenta. Runbook opisuje operacyjny przebieg zadania i zachowanie przy awarii. W praktyce dobry skill często zawiera własny runbook.
Jak poznać, że runbook jest dobry?
Po tym, że po błędzie dostajesz krótki, konkretny raport zamiast chaotycznej historii prób. Dobry runbook skraca drogę od problemu do decyzji.
Jeśli budujesz automatyzacje w OpenClaw, zacznij od jednego krytycznego workflowu i dopisz do niego trzy rzeczy: warunek sukcesu, warunki zatrzymania i obowiązkowe QA. To mały koszt, który bardzo szybko się zwraca.
Powiązane artykuły
Jeśli chcesz pogłębić ten temat, sprawdź też: