Rozwiązywanie problemów z kanałami OpenClaw — diagnostyka

Wprowadzenie

Ta strona zawiera wskazówki diagnostyczne, gdy kanały komunikacji łączą się, ale zachowują się nieprawidłowo. Niezależnie od platformy, zawsze zaczynaj od tych samych kroków diagnostycznych.

Wstępne komendy diagnostyczne

Uruchom następujące komendy w podanej kolejności:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Wskaźniki prawidłowego działania:

• Runtime w stanie running
• Pomyślne odpowiedzi na sondy RPC
• Połączony transport pokazujący status works lub audit ok

WhatsApp

Najczęstsze problemy z WhatsApp:

• Brak odpowiedzi na DM — niezatwierdzeni nadawcy blokują odpowiedzi; sprawdź openclaw pairing list whatsapp i listę dozwolonych
• Ignorowane wiadomości grupowe — filtrowanie na podstawie wymagań wzmianki; zweryfikuj groupPolicy, wpisy groups i groupAllowFrom
• Pętle uwierzytelniania — sprawdź stan katalogu poświadczeń (~/.openclaw/credentials/whatsapp/)
• Rozłączenia — uruchom openclaw doctor i openclaw channels login --channel whatsapp w razie potrzeby

Telegram

Typowe problemy z Telegramem:

• Komendy startowe nie działają — zweryfikuj token bota i sprawdź, czy /setprivacy jest poprawnie ustawione u BotFather
• Privacy mode blokuje grupy — tryb prywatności uniemożliwia odczyt wiadomości grupowych; wyłącz go w BotFather lub skonfiguruj wymaganie wzmianki
• Problemy sieciowe — routing DNS/IPv6 do serwerów API Telegrama; spróbuj wymusić IPv4
• Odrzucenie limitu komend — Telegram limituje liczbę niestandardowych komend; zredukuj liczbę komend

Discord

Typowe problemy z Discordem:

• Uprawnienia gildii/kanału — bot potrzebuje uprawnień View Channels, Send Messages, Read Message History; sprawdź role na serwerze
• Message Content Intent — musi być włączony w Discord Developer Portal; po zmianach zrestartuj Gateway
• Wymaganie wzmianki — zweryfikuj ustawienia requireMention w konfiguracji gildii
• DM nie docierają — sprawdź dmPolicy, parowanie i uprawnienia prywatności serwera

Slack

Problemy z integracją Slack:

• Konfiguracja tokenów — sprawdź oba tokeny: App Token (xapp-...) i Bot Token (xoxb-...)
• Brakujące zakresy OAuth — upewnij się, że manifest zawiera wszystkie wymagane zakresy
• Lista dozwolonych kanałów — zweryfikuj ID kanałów w konfiguracji channels.slack.channels
• Status tokenu unavailable — token jest skonfigurowany przez SecretRef, ale runtime nie może rozwiązać wartości

iMessage i BlueBubbles

• Nieosiągalny webhook — zweryfikuj URL i sprawdź, czy Gateway jest dostępny z sieci
• Uprawnienia macOS — Full Disk Access i Automation muszą być przyznane; zarządzaj przez ustawienia TCC
• Blokowanie nadawcy — sprawdź listy dozwolonych i politykę DM

Signal

• Nieosiągalny demon — zweryfikuj, czy signal-cli jest uruchomiony i osiągalny pod skonfigurowanym adresem
• Oczekujące parowanie — sprawdź openclaw pairing list signal
• Błędy rejestracji — upewnij się, że captcha została poprawnie rozwiązana i kod SMS zweryfikowany

Matrix

• Weryfikacja poświadczeń — sprawdź adres homeservera i ważność tokenu dostępu
• Szyfrowanie — zweryfikuj status weryfikacji urządzenia przez openclaw matrix verify status
• Problemy z pokojami — sprawdź autoJoin, groupPolicy i listy dozwolonych pokoi

Google Chat

• Błąd 405 — brakująca konfiguracja, wyłączona wtyczka lub niezrestartowany Gateway
• Błędy uwierzytelniania — zweryfikuj plik konta usługi i typ audytorium

Microsoft Teams

• Brak odpowiedzi — sprawdź uprawnienia RSC, webhook URL i endpoint Azure Bot
• Brakujące obrazy — dodaj uprawnienia Graph API
• Duplikaty wiadomości — timeouty webhooków powodują ponowne próby; dostosuj timeout

Ogólne wskazówki

• Zawsze sprawdzaj logi: openclaw logs --follow
• Używaj openclaw doctor do automatycznej diagnostyki
• Sprawdzaj status kanałów: openclaw channels status --probe
• Po zmianach konfiguracji restartuj Gateway
• Pamiętaj, że zatwierdzenie parowania DM nie daje automatycznie dostępu do komend grupowych