OpenClaw nie odpowiada: jak ustalić przyczynę

Wysyłasz wiadomość i nic nie wraca. Samodzielnie hostowany asystent ma cztery miejsca, w których odpowiedź może zginąć, i z okna czatu wyglądają one identycznie. Sprawdzenie ich po kolei zajmuje około pięciu minut i zamienia milczącego bota w konkretną, naprawialną usterkę.

Cztery warstwy

Zanim cokolwiek zmienisz, wiedz, co testujesz. Wiadomość przechodzi przez wszystkie cztery warstwy i każda z nich może ją pochłonąć bez błędu, który do ciebie dotrze:

1. Instancja. Czy OpenClaw faktycznie działa na twoim serwerze?
2. Dostawca modelu. Czy model językowy przyjmuje twoje żądania?
3. Integracja czatu. Czy wiadomość w ogóle dociera do OpenClaw?
4. Ścieżka sieciowa. Czy ty i platforma możecie dotrzeć do instancji?

Jeden test dzieli problem na pół od razu: wyślij wiadomość w interfejsie webowym OpenClaw. Jeśli tam dostaniesz odpowiedź, warstwy pierwsza i druga są w porządku, a problem leży w integracji. Jeśli nie, przestań patrzeć na bota.

Warstwa 1: czy instancja działa?

Otwórz panel Flux i sprawdź, czy instancja jest uruchomiona, a nie restartuje się w pętli. Kontener, który ciągle pada i wraca, to najmniej oczywista wersja tego problemu, bo między restartami usługa wygląda na obecną.

Zwykłą przyczyną pętli restartów jest pamięć. Jeśli wskazałeś OpenClaw na lokalny model, a nie na hostowane API, wagi modelu muszą mieścić się w tej samej pamięci RAM co wszystko inne. Model 7B skwantyzowany do 4 bitów to mniej więcej 4 GB wag, zanim doliczysz kontekst rozmowy i sam proces asystenta. Na pakiecie 4 GB to nie zadziała, a realnym minimum dla lokalnego wnioskowania jest pakiet 8 GB. Albo przejdź na wyższy pakiet, albo wskaż hostowany model, gdzie ciężka praca dzieje się na sprzęcie dostawcy, a twoja instancja musi tylko trzymać rozmowę.

Jeśli w ogóle nie możesz dotrzeć do interfejsu webowego, zanotuj ten fakt i przejdź do warstwy czwartej, zanim uznasz, że instancja jest zepsuta.

Warstwa 2: czy dostawca modelu cię odrzuca?

OpenClaw jest niezależny od modelu, a ty przynosisz własny klucz, co oznacza, że najczęstsza cisza nie ma nic wspólnego z OpenClaw. Cztery błędy po stronie dostawcy powodują asystenta, który przestaje odpowiadać, i z okna czatu są nie do odróżnienia:

• Klucz jest nieważny lub został zmieniony. Klucze są unieważniane, generowane na nowo i wklejane z końcową spacją. Wklej go ponownie zamiast uznawać, że wygląda dobrze.
• Saldo kredytów jest puste. Konta płatne za użycie przestają obsługiwać żądania w chwili, gdy saldo się wyczerpie, bez żadnego ostrzeżenia w asystencie.
• Dostajesz limit szybkości. Nowe konta u każdego głównego dostawcy są na niskich poziomach limitu żądań na minutę. Seria wiadomości albo pętla agenta, który wielokrotnie wywołuje model, uderzy w ten sufit, a każde odrzucone żądanie nie zwraca czatowi nic użytecznego.
• Nazwa modelu już nie istnieje. Dostawcy wycofują identyfikatory modeli, a konfiguracja napisana miesiące temu może wskazywać coś, co zostało już wycofane. Żądanie kończy się błędem złego modelu, a nie złego klucza, co łatwo źle odczytać.

Sprawdź panel samego dostawcy: strony zużycia, rozliczeń i limitów pokazują w kilka sekund, który z czterech problemów masz, a wszystkie cztery naprawia się tam, a nie w OpenClaw.

Warstwa 3: integracja czatu

Jeśli interfejs webowy odpowiada, a bot nie, wiadomość w ogóle nie dociera. Każda platforma ma jedną dominującą przyczynę i warto znać je po nazwie.

Telegram: Privacy Mode

Boty utworzone przez BotFather mają Privacy Mode włączony domyślnie. W grupie bot w tym stanie dostaje tylko wiadomości zaczynające się od komendy ukośnikowej albo odpowiadające botowi lub wspominające go bezpośrednio. Cała reszta nigdy nie trafia na twój serwer, więc asystent nie ignoruje ludzi, on naprawdę ich nie usłyszał. Dlatego ten sam bot świetnie odpowiada na wiadomości prywatne, a w grupie wygląda na martwego.

Żeby to naprawić, napisz do BotFather, otwórz Bot Settings dla swojego bota i wyłącz Group Privacy. Potem usuń bota z grupy i dodaj go ponownie, bo to ustawienie stosuje się w momencie dołączenia bota.

Discord: Message Content Intent

Od 2022 roku Discord traktuje treść wiadomości jako uprzywilejowane dane. Bot bez włączonego Message Content Intent nadal się łączy, nadal pokazuje się jako online i dostaje zdarzenia wiadomości z pustym polem treści. Efekt to bot, który na pewno działa, a nie reaguje absolutnie na nic.

Włącz go w Discord Developer Portal, w swojej aplikacji: Bot, Privileged Gateway Intents, a potem zrestartuj integrację. Przy okazji sprawdź, czy bot ma uprawnienie do czytania i wysyłania wiadomości w konkretnym kanale: nadpisania na poziomie kanału po cichu wygrywają z rolami na poziomie serwera, i bot z uprawnieniami serwera może nadal być wyciszony w jednym pokoju.

WhatsApp: sesja

Połączenia WhatsApp są powiązane z połączoną sesją, a nie z trwałym tokenem. Sesje wygasają, są wylogowywane z telefonu albo psują się, gdy urządzenie długo jest offline. Milcząca integracja WhatsApp to najczęściej sesja, którą trzeba połączyć ponownie. Zeskanuj kod jeszcze raz i przetestuj, zanim będziesz szukać gdzie indziej.

Wszystkie platformy: sam token

Na każdej platformie upewnij się, że token w panelu jest aktualny. Wygenerowanie nowego tokenu bota w konsoli platformy unieważnia stary od razu, a bardzo łatwo wygenerować token podczas badania czegoś innego i zapomnieć wkleić nowy z powrotem.

Warstwa 4: ścieżka sieciowa

Jeśli łączysz się z OpenClaw przez Tailscale, asystent może być w pełni zdrowy, a ty po prostu nie możesz do niego dotrzeć. Klucze autoryzacji wygasają, i klucze urządzeń też, więc instancja działająca bez nadzoru przez miesiące może wypaść z twojej tailnet bez żadnej awarii. Sprawdź konsolę administracyjną Tailscale i potwierdź, że urządzenie jest nadal na liście i nadal autoryzowane. Jeśli nie, wygeneruj nowy klucz autoryzacji i wdróż ponownie albo połącz się na nowo.

Ta warstwa wyjaśnia mylący wzorzec: bot nadal odpowiada na czacie, podczas gdy interfejs webowy jest dla ciebie nieosiągalny. Instancja jest w porządku i działa; zniknęła tylko twoja droga do niej.

Odpowiada, ale źle

Wolna albo obcięta odpowiedź to inny problem niż cisza i zwykle wynika z jednej z dwóch rzeczy. Długie rozmowy w końcu przekraczają okno kontekstu modelu, po czym żądania zaczynają się wysypywać albo asystent gubi wcześniejszą część wątku. Natychmiastową poprawką jest rozpoczęcie nowej rozmowy. Osobno, duży lokalny model na skromnym sprzęcie po prostu działa wolno, a odpowiedź, która trwa minutę, może przekroczyć limit czasu gdzieś w łańcuchu, zanim zostanie dostarczona. Jeśli potrzebujesz szybkości na małej instancji, hostowany model pobije lokalny za każdym razem.

Lista kontrolna na pięć minut

1. Wyślij wiadomość w interfejsie webowym OpenClaw. Odpowiedź tam oznacza, że problem leży w integracji; brak odpowiedzi oznacza, że problemem jest instancja, dostawca albo twoja droga do niej.
2. Sprawdź instancję w panelu Flux pod kątem pętli restartów, a jeśli używasz lokalnego modelu, sprawdź RAM.
3. Sprawdź panel samego dostawcy modelu pod kątem nieważnego klucza, pustego salda, limitu szybkości albo wycofanej nazwy modelu.
4. W przypadku Telegrama wyłącz Privacy Mode w BotFather i dodaj bota do grupy ponownie.
5. W przypadku Discorda włącz Message Content Intent i sprawdź uprawnienia na poziomie kanału.
6. W przypadku WhatsApp połącz sesję ponownie.
7. Jeśli interfejs webowy jest nieosiągalny, ale czat działa, sprawdź w Tailscale, czy urządzenie lub klucz autoryzacji nie wygasły.

Prawie każdy przypadek kończy się na kroku pierwszym, trzecim lub czwartym. Warto zapamiętać, że samodzielnie hostowany asystent ma więcej ruchomych części niż SaaS, dokładnie dlatego, że ich właścicielem jesteś, a bycie właścicielem oznacza, że usterkę zawsze da się zlokalizować.

Dalsza lektura

Jeśli dopiero zaczynasz z takim asystentem, zacznij od przewodnika self-hostingu OpenClaw albo przeczytaj o wyborze modelu AI, jeśli zastanawiasz się między hostowanym dostawcą a lokalnym modelem. Same integracje opisują Telegram, Discord i WhatsApp.