> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw status --all
openclaw doctor --fix
openclaw gateway restart
openclaw 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.

## WhatsApp

### 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](/pl/channels/whatsapp#troubleshooting)

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

Pełne rozwiązywanie problemów: [Rozwiązywanie problemów z Telegram](/pl/channels/telegram#troubleshooting)

## 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](/pl/channels/ambient-room-events) 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](/pl/channels/discord#troubleshooting)

## 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](/pl/channels/slack#troubleshooting)

## 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](/pl/channels/imessage#troubleshooting)

## 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](/pl/channels/signal#troubleshooting)

## 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](/pl/channels/qqbot#troubleshooting)

## 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](/pl/channels/matrix)

## Powiązane

* [Parowanie](/pl/channels/pairing)
* [Routing kanałów](/pl/channels/channel-routing)
* [Rozwiązywanie problemów z Gateway](/pl/gateway/troubleshooting)
