Przejdź do głównej treści

​
Rozwiązywanie problemów z kanałami

Użyj tej strony, gdy kanał się łączy, ale działa nieprawidłowo.

​
Sekwencja poleceń

Najpierw uruchom je w tej kolejności: 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Prawidłowy stan bazowy:
  • Runtime: running
  • RPC probe: ok
  • Sonda kanału pokazuje połączony transport oraz, tam gdzie jest to obsługiwane, works lub audit ok

​
WhatsApp

​
Sygnatury awarii WhatsApp

ObjawNajszybsza kontrolaPoprawka
Połączono, ale brak odpowiedzi w DMopenclaw pairing list whatsappZatwierdź nadawcę albo zmień politykę DM/listę dozwolonych.
Wiadomości grupowe są ignorowaneSprawdź requireMention + wzorce wzmianek w konfiguracjiWspomnij bota albo złagodź politykę wzmianek dla tej grupy.
Losowe pętle rozłączeń/ponownych logowańopenclaw channels status --probe + logiZaloguj się ponownie i sprawdź, czy katalog poświadczeń jest w dobrym stanie.
Pełne rozwiązywanie problemów: /channels/whatsapp#troubleshooting

​
Telegram

​
Sygnatury awarii Telegram

ObjawNajszybsza kontrolaPoprawka
/start, ale brak użytecznego przepływu odpowiedziopenclaw pairing list telegramZatwierdź parowanie albo zmień politykę DM.
Bot jest online, ale grupa milczySprawdź wymóg wzmianki i tryb prywatności botaWyłącz tryb prywatności dla widoczności w grupie albo wspomnij bota.
Błędy wysyłania z błędami sieciowymiSprawdź logi pod kątem błędów wywołań API TelegramNapraw routing DNS/IPv6/proxy do api.telegram.org.
setMyCommands odrzucone przy uruchamianiuSprawdź logi pod kątem BOT_COMMANDS_TOO_MUCHOgranicz komendy plugin/Skills/własne komendy Telegram albo wyłącz natywne menu.
Po aktualizacji lista dozwolonych Cię blokujeopenclaw security audit i listy dozwolonych w konfiguracjiUruchom openclaw doctor --fix albo zastąp @username numerycznymi identyfikatorami nadawców.
Pełne rozwiązywanie problemów: /channels/telegram#troubleshooting

​
Discord

​
Sygnatury awarii Discord

ObjawNajszybsza kontrolaPoprawka
Bot jest online, ale brak odpowiedzi na serwerzeopenclaw channels status --probeZezwól na serwer/kanał i sprawdź uprawnienie message content.
Wiadomości grupowe są ignorowaneSprawdź logi pod kątem odrzuceń przez reguły wzmianekWspomnij bota albo ustaw requireMention: false dla serwera/kanału.
Brak odpowiedzi w DMopenclaw pairing list discordZatwierdź parowanie DM albo dostosuj politykę DM.
Pełne rozwiązywanie problemów: /channels/discord#troubleshooting

​
Slack

​
Sygnatury awarii Slack

ObjawNajszybsza kontrolaPoprawka
Socket mode połączony, ale brak odpowiedziopenclaw channels status --probeSprawdź token aplikacji + token bota i wymagane zakresy; obserwuj botTokenStatus / appTokenStatus = configured_unavailable w konfiguracjach opartych na SecretRef.
DM są blokowaneopenclaw pairing list slackZatwierdź parowanie albo złagodź politykę DM.
Wiadomość na kanale jest ignorowanaSprawdź groupPolicy i listę dozwolonych kanałówZezwól na kanał albo przełącz politykę na open.
Pełne rozwiązywanie problemów: /channels/slack#troubleshooting

​
iMessage i BlueBubbles

​
Sygnatury awarii iMessage i BlueBubbles

ObjawNajszybsza kontrolaPoprawka
Brak zdarzeń przychodzącychSprawdź osiągalność webhooka/serwera i uprawnienia aplikacjiNapraw URL webhooka albo stan serwera BlueBubbles.
Można wysyłać, ale brak odbioru na macOSSprawdź uprawnienia prywatności macOS dla automatyzacji MessagesNadaj ponownie uprawnienia TCC i uruchom ponownie proces kanału.
Nadawca DM jest blokowanyopenclaw pairing list imessage lub openclaw pairing list bluebubblesZatwierdź parowanie albo zaktualizuj listę dozwolonych.
Pełne rozwiązywanie problemów:

​
Signal

​
Sygnatury awarii Signal

ObjawNajszybsza kontrolaPoprawka
Demon jest osiągalny, ale bot milczyopenclaw channels status --probeSprawdź URL/konto demona signal-cli oraz tryb odbioru.
DM są blokowaneopenclaw pairing list signalZatwierdź nadawcę albo dostosuj politykę DM.
Odpowiedzi w grupie nie są wyzwalaneSprawdź listę dozwolonych grup i wzorce wzmianekDodaj nadawcę/grupę albo złagodź reguły blokujące.
Pełne rozwiązywanie problemów: /channels/signal#troubleshooting

​
QQ Bot

​
Sygnatury awarii QQ Bot

ObjawNajszybsza kontrolaPoprawka
Bot odpowiada „gone to Mars”Sprawdź appId i clientSecret w konfiguracjiUstaw poświadczenia albo uruchom ponownie gateway.
Brak wiadomości przychodzącychopenclaw channels status --probeZweryfikuj poświadczenia na QQ Open Platform.
Mowa nie jest transkrybowanaSprawdź konfigurację dostawcy STTSkonfiguruj channels.qqbot.stt lub tools.media.audio.
Wiadomości proaktywne nie docierająSprawdź wymagania platformy QQ dotyczące interakcjiQQ może blokować wiadomości inicjowane przez bota bez niedawnej interakcji.
Pełne rozwiązywanie problemów: /channels/qqbot#troubleshooting

​
Matrix

​
Sygnatury awarii Matrix

ObjawNajszybsza kontrolaPoprawka
Zalogowano, ale ignoruje wiadomości w pokojuopenclaw channels status --probeSprawdź groupPolicy, listę dozwolonych pokoi i reguły wzmianek.
DM nie są przetwarzaneopenclaw pairing list matrixZatwierdź nadawcę albo dostosuj politykę DM.
Szyfrowane pokoje nie działająopenclaw matrix verify statusZweryfikuj urządzenie ponownie, a następnie sprawdź openclaw matrix verify backup status.
Przywracanie kopii zapasowej oczekuje/jest uszkodzoneopenclaw matrix verify backup statusUruchom openclaw matrix verify backup restore albo wykonaj ponownie z kluczem odzyskiwania.
Cross-signing/bootstrap wygląda nieprawidłowoopenclaw matrix verify bootstrapNapraw magazyn sekretów, cross-signing i stan kopii zapasowej w jednym przebiegu.
Pełna konfiguracja i ustawienia: Matrix