Zum Hauptinhalt springen

​
Fehlerbehebung für Kanäle

Verwenden Sie diese Seite, wenn ein Kanal eine Verbindung herstellt, das Verhalten aber falsch ist.

​
Befehlsleiter

Führen Sie diese zuerst in dieser Reihenfolge aus: 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Gesunde Ausgangsbasis:
  • Runtime: running
  • RPC probe: ok
  • Die Kanalprüfung zeigt einen verbundenen Transport und, wo unterstützt, works oder audit ok

​
WhatsApp

​
Fehlersignaturen bei WhatsApp

SymptomSchnellste PrüfungKorrektur
Verbunden, aber keine DM-Antwortenopenclaw pairing list whatsappAbsender genehmigen oder DM-Richtlinie/Allowlist ändern.
Gruppennachrichten werden ignoriertrequireMention + Erwähnungsmuster in der Konfiguration prüfenBot erwähnen oder Erwähnungsrichtlinie für diese Gruppe lockern.
Zufällige Verbindungsabbrüche/erneute Anmeldung in Schleifeopenclaw channels status --probe + LogsErneut anmelden und prüfen, ob das Verzeichnis mit Anmeldedaten intakt ist.
Vollständige Fehlerbehebung: /channels/whatsapp#troubleshooting

​
Telegram

​
Fehlersignaturen bei Telegram

SymptomSchnellste PrüfungKorrektur
/start, aber kein nutzbarer Antwortflussopenclaw pairing list telegramKopplung genehmigen oder DM-Richtlinie ändern.
Bot online, aber Gruppe bleibt stillErwähnungspflicht und Datenschutzmodus des Bots prüfenDatenschutzmodus für Gruppensichtbarkeit deaktivieren oder Bot erwähnen.
Sendeprobleme mit NetzwerkfehlernLogs auf Fehler bei Telegram-API-Aufrufen prüfenDNS-/IPv6-/Proxy-Routing zu api.telegram.org korrigieren.
setMyCommands wird beim Start abgelehntLogs auf BOT_COMMANDS_TOO_MUCH prüfenPlugin-/Skills-/benutzerdefinierte Telegram-Befehle reduzieren oder native Menüs deaktivieren.
Upgrade durchgeführt und Allowlist blockiert Sieopenclaw security audit und Konfigurations-Allowlistsopenclaw doctor --fix ausführen oder @username durch numerische Absender-IDs ersetzen.
Vollständige Fehlerbehebung: /channels/telegram#troubleshooting

​
Discord

​
Fehlersignaturen bei Discord

SymptomSchnellste PrüfungKorrektur
Bot online, aber keine Guild-Antwortenopenclaw channels status --probeGuild/Kanal zulassen und Intent für Nachrichteninhalt prüfen.
Gruppennachrichten werden ignoriertLogs auf durch Mention-Gating verworfene Nachrichten prüfenBot erwähnen oder requireMention: false für Guild/Kanal setzen.
DM-Antworten fehlenopenclaw pairing list discordDM-Kopplung genehmigen oder DM-Richtlinie anpassen.
Vollständige Fehlerbehebung: /channels/discord#troubleshooting

​
Slack

​
Fehlersignaturen bei Slack

SymptomSchnellste PrüfungKorrektur
Socket Mode verbunden, aber keine Antwortenopenclaw channels status --probeApp-Token + Bot-Token und erforderliche Scopes prüfen; bei SecretRef-gestützten Setups auf botTokenStatus / appTokenStatus = configured_unavailable achten.
DMs blockiertopenclaw pairing list slackKopplung genehmigen oder DM-Richtlinie lockern.
Kanalnachricht wird ignoriertgroupPolicy und Kanal-Allowlist prüfenKanal zulassen oder Richtlinie auf open setzen.
Vollständige Fehlerbehebung: /channels/slack#troubleshooting

​
iMessage und BlueBubbles

​
Fehlersignaturen bei iMessage und BlueBubbles

SymptomSchnellste PrüfungKorrektur
Keine eingehenden EreignisseErreichbarkeit von Webhook/Server und App-Berechtigungen prüfenWebhook-URL oder BlueBubbles-Serverstatus korrigieren.
Senden funktioniert, aber kein Empfang unter macOSmacOS-Datenschutzberechtigungen für Messages-Automatisierung prüfenTCC-Berechtigungen erneut erteilen und Kanalprozess neu starten.
DM-Absender blockiertopenclaw pairing list imessage oder openclaw pairing list bluebubblesKopplung genehmigen oder Allowlist aktualisieren.
Vollständige Fehlerbehebung:

​
Signal

​
Fehlersignaturen bei Signal

SymptomSchnellste PrüfungKorrektur
Daemon erreichbar, aber Bot bleibt stillopenclaw channels status --probeURL/Konto des signal-cli-Daemon und Empfangsmodus prüfen.
DM blockiertopenclaw pairing list signalAbsender genehmigen oder DM-Richtlinie anpassen.
Gruppenantworten werden nicht ausgelöstGruppen-Allowlist und Erwähnungsmuster prüfenAbsender/Gruppe hinzufügen oder Gating lockern.
Vollständige Fehlerbehebung: /channels/signal#troubleshooting

​
QQ Bot

​
Fehlersignaturen bei QQ Bot

SymptomSchnellste PrüfungKorrektur
Bot antwortet „gone to Mars“appId und clientSecret in der Konfiguration prüfenAnmeldedaten setzen oder das Gateway neu starten.
Keine eingehenden Nachrichtenopenclaw channels status --probeAnmeldedaten auf der QQ Open Platform prüfen.
Sprache wird nicht transkribiertSTT-Provider-Konfiguration prüfenchannels.qqbot.stt oder tools.media.audio konfigurieren.
Proaktive Nachrichten kommen nicht anAnforderungen der QQ-Plattform für Interaktionen prüfenQQ kann vom Bot initiierte Nachrichten ohne kürzliche Interaktion blockieren.
Vollständige Fehlerbehebung: /channels/qqbot#troubleshooting

​
Matrix

​
Fehlersignaturen bei Matrix

SymptomSchnellste PrüfungKorrektur
Angemeldet, ignoriert aber Raumnachrichtenopenclaw channels status --probegroupPolicy, Raum-Allowlist und Mention-Gating prüfen.
DMs werden nicht verarbeitetopenclaw pairing list matrixAbsender genehmigen oder DM-Richtlinie anpassen.
Verschlüsselte Räume schlagen fehlopenclaw matrix verify statusGerät erneut verifizieren, dann openclaw matrix verify backup status prüfen.
Backup-Wiederherstellung ist ausstehend/fehlerhaftopenclaw matrix verify backup statusopenclaw matrix verify backup restore ausführen oder mit einem Wiederherstellungsschlüssel erneut versuchen.
Cross-Signing/Bootstrap sieht falsch ausopenclaw matrix verify bootstrapSecret Storage, Cross-Signing und Backup-Status in einem Durchgang reparieren.
Vollständige Einrichtung und Konfiguration: Matrix