Jak naprawić zawieszającego się OpenClaw w czacie: diagnostyka i rozwiązania

Jak powinien wyglądać prawidłowy stan

• Wynik

  openclaw gateway status

  musi pokazywać

  Runtime: running

  oraz

  Connectivity probe: ok

  .

• openclaw channels status --probe

  powinno wskazywać połączony transport (transport connected), a tam, gdzie to obsługiwane, status works lub

  audit ok

  .
• W poleceniu

  openclaw status

  nie powinieneś widzieć żadnych oczywistych błędów autoryzacji lub konfiguracji.

Jeśli problem pojawił się po aktualizacji

• Dokumentacja OpenClaw mówi, że jeśli kanał zniknął lub bot zaciął się po aktualizacji, należy uruchomić sekwencję:

  openclaw status --all

  , następnie

  openclaw doctor --fix

  , potem

  openclaw gateway restart

  i ponownie sprawdzić

  openclaw status --all

  .
• Jeśli widzisz błąd

  plugin load failed: dependency tree corrupted

  , oznacza to uszkodzenie ścieżki wtyczki lub konfiguracji. Oficjalnym sposobem naprawy jest właśnie polecenie

  openclaw doctor --fix

  .

Jeśli dotyczy to czatu na Telegramie

• Dla Telegrama główne oznaki awarii to: bot jest online, ale nie udziela użytecznych odpowiedzi; grupa milczy z powodu trybu prywatności (privacy mode) lub wymogu oznaczenia (mention gating); błędy wysyłania spowodowane przez problemy sieciowe z API Telegrama; błąd tokena (401) z getMe; lub zacięcie/zbyt wolne ponowne łączenie się pollingu.
• Jeśli komenda /start działa, ale bot nie daje sensownej odpowiedzi, najpierw sprawdź

  openclaw pairing list telegram

  .
• Jeśli bot jest online, ale ignoruje wiadomości na grupie, sprawdź wymóg oznaczania bota (@nazwa_bota) oraz czy w ustawieniach grupy wyłączono tryb prywatności dla bota (pozwala mu to widzieć wszystkie wiadomości).
• Jeśli logi pokazują błędy sieciowe (network error) do API Telegrama, problem leży w konfiguracji DNS, IPv6 lub routingu proxy.
• Jeśli zaraz po starcie pojawia się

  getMe returned 401

  , musisz zaktualizować token uzyskany od BotFather; sprawdź go w polach konfiguracyjnych botToken, tokenFile lub zmiennej środowiskowej TELEGRAM_BOT_TOKEN.
• Jeśli polling się zacina (stall) lub reconnect trwa zbyt długo, dokumentacja radzi najpierw przeanalizować

  openclaw logs --follow

  ; jeśli problem nie ustępuje, przyczyna i tak zwykle leży po stronie proxy/DNS/IPv6.

Jeśli to gateway jest źródłem problemu

• Jeśli polecenie openclaw w terminalu niechcący odwołuje się do starej wersji binarnej, dokumentacja zaleca poprawienie zmiennej środowiskowej PATH, tak aby wskazywała na nowszą instalację. Dopiero potem spróbuj ponownie wykonać akcję.
• Jeśli usługa gatewaya (gateway service) ma rozbieżną wersję instalacji lub korzysta ze starego wrappera, zaleca się ponowną instalację właściwej wersji usługi (reinstall) i usunięcie przestarzałych plików wrappera/opakowania.

Szybka diagnostyka po objawach

• Gateway nie działa / test sondy nie przechodzi → działaj w gałęzi rozwiązań dla gatewaya/usługi/PATH.
• Gateway działa, ale bot na czacie nie odpowiada → skieruj uwagę na przepływ w kanale, parowanie (pairing), wymóg oznaczania (mention gating), tryb prywatności, token oraz połączenie sieciowe z API Telegrama.
• Problem zaczął się zaraz po aktualizacji → priorytetem jest sekwencja

  doctor --fix

  + restart gatewaya.
• Logi zapętlają błędy krytyczne (fatal errors) → to znak, że błąd leży w uszkodzonej konfiguracji lub wtyczce, a nie jest to jedynie chwilowe opóźnienie.

Podsumowanie

Nie zgaduj. W przypadku OpenClaw poprawna naprawa polega na uruchomieniu 5 podstawowych poleceń diagnostycznych, a dopiero potem na rozwiązywaniu problemu w odpowiedniej gałęzi — dla Telegrama, gatewaya lub wtyczek. Jeśli uruchomisz powyższy zestaw poleceń i wkleisz pierwsze 20–30 linijek z wyników

openclaw gateway status

openclaw channels status --probe

openclaw logs --follow