Configuration

Rozwiązywanie problemów z kanałami

Użyj tej strony, gdy kanał się łączy, ale zachowanie jest nieprawidłowe.

Drabina poleceń

Najpierw uruchom je w tej kolejności:

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Zdrowy stan bazowy:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable lub admin-capable
Sonda kanału pokazuje, że transport jest połączony oraz, tam gdzie jest to obsługiwane, works lub audit ok

Po aktualizacji

Użyj tego, gdy Telegram, iMessage, konfiguracje z ery BlueBubbles albo inny kanał Plugin znika po aktualizacji.

bash

openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --all

Szukaj 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.

Pełne rozwiązywanie problemów: Rozwiązywanie problemów z WhatsApp

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.

Pełne rozwiązywanie problemów: Rozwiązywanie problemów z Telegram

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.

Pełne rozwiązywanie problemów: Rozwiązywanie problemów z Discord

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`.

Pełne rozwiązywanie problemów: Rozwiązywanie problemów ze Slack

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.

Pełne rozwiązywanie problemów:

Rozwiązywanie problemów z iMessage

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.

Pełne rozwiązywanie problemów: Rozwiązywanie problemów z Signal

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.

Pełne rozwiązywanie problemów: rozwiązywanie problemów z QQ Bot

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.

Pełna konfiguracja i ustawienia: Matrix

Powiązane

Was this useful?