Drabina poleceń
Najpierw uruchom je w tej kolejności:Runtime: runningConnectivity probe: okCapability: read-only,write-capablelubadmin-capable- Sonda kanału pokazuje, że transport jest połączony oraz, tam gdzie jest to obsługiwane,
workslubaudit ok
Po aktualizacji
Użyj tego, gdy Telegram, iMessage, konfiguracje z ery BlueBubbles albo inny kanał Plugin znika po aktualizacji.plugin load failed: dependency tree corrupted; run openclaw doctor --fix w openclaw status --all. Oznacza to, że kanał jest skonfigurowany, ale
ścieżka konfiguracji/ładowania Plugin natrafiła na uszkodzone drzewo zależności zamiast zarejestrować
kanał. openclaw doctor --fix usuwa nieaktualne katalogi staging zależności Plugin
i nieaktualne cienie uwierzytelniania, a następnie openclaw gateway restart ponownie ładuje
czysty stan.
Sygnatury awarii WhatsApp
| Objaw | Najszybsze sprawdzenie | Naprawa |
|---|---|---|
| Połączono, ale brak odpowiedzi DM | openclaw pairing list whatsapp | Zatwierdź nadawcę albo zmień zasady/listę dozwolonych DM. |
| Wiadomości grupowe ignorowane | Sprawdź requireMention + wzorce wzmianek w konfiguracji | Wspomnij bota albo złagodź zasady wzmianek dla tej grupy. |
| Logowanie QR kończy się 408 | Sprawdź zmienne środowiskowe Gateway HTTPS_PROXY / HTTP_PROXY | Ustaw osiągalne proxy; używaj NO_PROXY tylko do obejść. |
| Losowe pętle rozłączeń/ponownych logowań | openclaw channels status --probe + logi | Ostatnie ponowne połączenia są oznaczane nawet przy aktualnym połączeniu; obserwuj logi, zrestartuj Gateway, a potem ponownie połącz, jeśli niestabilność trwa. |
Pętla status=408 Request Time-out | Sonda, logi, doctor, potem status Gateway | Najpierw napraw łączność/czasowanie hosta; wykonaj kopię zapasową uwierzytelniania i ponownie połącz konto, jeśli pętla się utrzymuje. |
| Odpowiedzi przychodzą po sekundach/minutach | openclaw doctor --fix | Doctor zatrzymuje zweryfikowane nieaktualne lokalne klienty TUI, gdy degradują pętlę zdarzeń Gateway. |
Telegram
Sygnatury awarii Telegram
| Objaw | Najszybsze sprawdzenie | Naprawa |
|---|---|---|
/start, ale brak użytecznego przepływu odpowiedzi | openclaw pairing list telegram | Zatwierdź parowanie albo zmień zasady DM. |
| Bot online, ale grupa pozostaje cicha | Zweryfikuj wymóg wzmianki i tryb prywatności bota | Wyłącz tryb prywatności dla widoczności grupy albo wspomnij bota. |
| Błędy wysyłania z błędami sieci | Przejrzyj logi pod kątem nieudanych wywołań API Telegram | Napraw routing DNS/IPv6/proxy do api.telegram.org. |
Przy starcie zgłoszono getMe returned 401 | Sprawdź skonfigurowane źródło tokenu | Skopiuj ponownie albo wygeneruj od nowa token BotFather i zaktualizuj botToken, tokenFile lub TELEGRAM_BOT_TOKEN konta domyślnego. |
| Polling zacina się albo powoli łączy ponownie | openclaw logs --follow dla diagnostyki pollingu | Zaktualizuj; jeśli restarty są fałszywymi alarmami, dostrój pollingStallThresholdMs. Utrzymujące się zacięcia nadal wskazują proxy/DNS/IPv6. |
setMyCommands odrzucone przy starcie | Przejrzyj logi pod kątem BOT_COMMANDS_TOO_MUCH | Zmniejsz liczbę poleceń Telegram z Plugin/skill/niestandardowych albo wyłącz natywne menu. |
| Po aktualizacji lista dozwolonych blokuje Ciebie | openclaw security audit i listy dozwolonych w konfiguracji | Uruchom openclaw doctor --fix albo zastąp @username numerycznymi ID nadawców. |
Discord
Sygnatury awarii Discord
| Objaw | Najszybsze sprawdzenie | Naprawa |
|---|---|---|
| Bot online, ale brak odpowiedzi w gildii | openclaw channels status --probe | Zezwól na gildię/kanał i zweryfikuj intencję zawartości wiadomości. |
| Wiadomości grupowe ignorowane | Sprawdź logi pod kątem odrzuceń przez bramkowanie wzmianek | Wspomnij bota albo ustaw dla gildii/kanału requireMention: false. |
| Użycie pisania/tokenu, ale brak wiadomości Discord | Sprawdź, czy to zdarzenie pokoju ambientowego, czy pokój message_tool z opt-in, w którym model pominął message(action=send) | Przejrzyj szczegółowy log Gateway pod kątem metadanych stłumionego finalnego payloadu, zweryfikuj messages.groupChat.unmentionedInbound, przeczytaj Zdarzenia pokoju ambientowego albo pozostaw messages.groupChat.visibleReplies: "automatic" dla zwykłych żądań grupowych. |
| Brak odpowiedzi DM | openclaw pairing list discord | Zatwierdź parowanie DM albo dostosuj zasady DM. |
Slack
Sygnatury awarii Slack
| Objaw | Najszybsze sprawdzenie | Naprawa |
|---|---|---|
| Tryb socket połączony, ale brak odpowiedzi | openclaw channels status --probe | Zweryfikuj token aplikacji + token bota i wymagane zakresy; obserwuj botTokenStatus / appTokenStatus = configured_unavailable w konfiguracjach opartych na SecretRef. |
| DM zablokowane | openclaw pairing list slack | Zatwierdź parowanie albo złagodź zasady DM. |
| Wiadomość kanału zignorowana | Sprawdź groupPolicy i listę dozwolonych kanałów | Zezwól na kanał albo przełącz zasadę na open. |
iMessage
Sygnatury awarii iMessage
| Objaw | Najszybsze sprawdzenie | Naprawa |
|---|---|---|
Brak imsg albo nie działa poza macOS | openclaw channels status --probe --channel imessage | Uruchom OpenClaw na Macu z Messages albo użyj wrappera SSH dla cliPath. |
| Można wysyłać, ale nie odbierać na macOS | Sprawdź uprawnienia prywatności macOS dla automatyzacji Messages | Przyznaj ponownie uprawnienia TCC i zrestartuj proces kanału. |
| Nadawca DM zablokowany | openclaw pairing list imessage | Zatwierdź parowanie albo zaktualizuj listę dozwolonych. |
Signal
Sygnatury awarii Signal
| Objaw | Najszybsze sprawdzenie | Naprawa |
|---|---|---|
| Demon osiągalny, ale bot milczy | openclaw channels status --probe | Zweryfikuj URL/konto demona signal-cli i tryb odbioru. |
| DM zablokowane | openclaw pairing list signal | Zatwierdź nadawcę albo dostosuj zasady DM. |
| Odpowiedzi grupowe się nie uruchamiają | Sprawdź listę dozwolonych grup i wzorce wzmianek | Dodaj nadawcę/grupę albo poluzuj bramkowanie. |
QQ Bot
Sygnatury awarii QQ Bot
| Objaw | Najszybsze sprawdzenie | Naprawa |
|---|---|---|
| Bot odpowiada „gone to Mars” | Zweryfikuj appId i clientSecret w konfiguracji | Ustaw poświadczenia albo zrestartuj Gateway. |
| Brak wiadomości przychodzących | openclaw channels status --probe | Zweryfikuj poświadczenia na QQ Open Platform. |
| Głos nie jest transkrybowany | Sprawdź konfigurację dostawcy STT | Skonfiguruj channels.qqbot.stt albo tools.media.audio. |
| Wiadomości proaktywne nie docierają | Sprawdź wymagania interakcji platformy QQ | QQ może blokować wiadomości inicjowane przez bota bez niedawnej interakcji. |
Matrix
Sygnatury awarii Matrix
| Objaw | Najszybsza kontrola | Rozwiązanie |
|---|---|---|
| Zalogowano, ale ignoruje wiadomości w pokojach | openclaw channels status --probe | Sprawdź groupPolicy, listę dozwolonych pokojów i bramkowanie wzmianek. |
| DM nie są przetwarzane | openclaw pairing list matrix | Zatwierdź nadawcę albo dostosuj zasady DM. |
| Zaszyfrowane pokoje nie działają | openclaw matrix verify status | Zweryfikuj urządzenie ponownie, a następnie sprawdź openclaw matrix verify backup status. |
| Przywracanie kopii zapasowej oczekuje lub jest uszkodzone | openclaw matrix verify backup status | Uruchom openclaw matrix verify backup restore albo uruchom ponownie z kluczem odzyskiwania. |
| Podpisywanie krzyżowe/bootstrap wygląda nieprawidłowo | openclaw matrix verify bootstrap | Napraw magazyn sekretów, podpisywanie krzyżowe i stan kopii zapasowej w jednym przebiegu. |