Kiedy OpenClaw przestaje działać – diagnostyka krok po kroku

Telegram – najczęstsze objawy i rozwiązania

1. Bot jest online, ale ignoruje grupę

To jeden z najczęstszych problemów. Dokumentacja wskazuje dwie przyczyny :

• Prywatność bota: Jeśli bot nie widzi wszystkich wiadomości, użyj /setprivacy w BotFather, aby wyłączyć tryb prywatności (Disable).
• Wymóg wzmianki (requireMention): Jeśli skonfigurowano, bot reaguje tylko na wiadomości z @nazwa_bota. Można to złagodzić w konfiguracji.

Ważne: Po zmianie ustawień prywatności musisz usunąć bota z grupy i dodać go ponownie, by Telegram zastosował nowe reguły.

2. Błąd HTTP 401 przy starcie

Jeśli

openclaw logs

getMe returned 401

3. Konflikt odpytywania –

getUpdates 409

Ten błąd oznacza, że ten sam token bota jest już używany przez inną instancję OpenClaw Gateway, zewnętrzny skrypt lub poller. OpenClaw zabezpiecza przed tym wewnętrznie, ale jeśli ręcznie uruchomisz drugi proces, konflikt jest pewny. Dopilnuj, by na jeden token przypadał dokładnie jeden gateway .

4. Bot milczy w wiadomościach prywatnych (DM)

Jeśli użytkownik wysłał /start, ale nie widzi odpowiedzi, sprawdź listę parowania (

openclaw pairing list telegram

5. Niestabilne połączenie lub problemy sieciowe

Jeśli bot ciągle się rozłącza, logs wskazuje na błędy sieciowe lub polling blokuje się na >120 sekund, sprawdź po kolei :

• DNS i routing IPv6 do api.telegram.org
• Ustawienia proxy (w zmiennych środowiskowych lub konfiguracji)
• Ewentualnie zwiększ channels.telegram.pollingStallThresholdMs, jeśli fałszywie wykrywa przeciązenie.

Co robić po aktualizacji OpenClaw

Po wgraniu nowej wersji zawsze wykonaj sekwencję czyszczącą :

Jeśli widzisz komunikat

plugin load failed: dependency tree corrupted

openclaw doctor --fix

Konfiguracja Telegrama w OpenClaw – pamiętaj o szczegółach

• OpenClaw nie używa

  openclaw channels login telegram

  . Poświadczenia podaje się wyłącznie przez plik konfiguracyjny (channels.telegram.botToken) lub zmienne środowiskowe. Wystarczy ustawić

  channels.telegram.enabled: true

  i uruchomić gateway .
• Domyślna polityka dla DM wymaga parowania. Po restarcie gatewaya użytkownicy, którzy napiszą pierwsi, zobaczą kod parowania – musisz go zatwierdzić (

  openclaw pairing approve telegram KOD

  ).

Podsumowanie

Na podstawie dostępnych danych nie da się jednoznacznie stwierdzić, co dokładnie nie działa w Twoim przypadku. Ale bez wyjścia z tych pięciu obowiązkowych poleceń diagnostycznych nie ma sensu zgadywać.

W przypadku Telegrama cztery najbardziej podejrzane obszary to :

• Prywatność bota i wymóg wzmianki
• Błąd tokena 401
• Problemy z DNS/IPv6/proxy
• Konflikt odpytywania 409

Zbierz output diagnostyczny i porównaj z powyższą listą – to najszybsza droga do naprawy.