Zum Hauptinhalt springen

Fehlerbehebung für Kanäle

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

Befehlsabfolge

Führen Sie diese zuerst in dieser Reihenfolge aus:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Gesunde Basis:
  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable oder admin-capable
  • Die Kanalprüfung zeigt, dass der Transport verbunden ist und, falls unterstützt, works oder audit ok

WhatsApp

Fehlersignaturen für WhatsApp

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

Telegram

Fehlersignaturen für Telegram

SymptomSchnellste PrüfungKorrektur
/start, aber kein nutzbarer Antwortflussopenclaw pairing list telegramKopplung freigeben oder DM-Richtlinie ändern.
Bot online, aber Gruppe bleibt stillErwähnungsanforderung und Datenschutzmodus des Bots prüfenDatenschutzmodus für Gruppensichtbarkeit deaktivieren oder Bot erwähnen.
Sendefehler mit NetzwerkfehlernLogs auf fehlgeschlagene Telegram-API-Aufrufe prüfenDNS-/IPv6-/Proxy-Routing zu api.telegram.org korrigieren.
Polling stockt oder verbindet sich langsam neuopenclaw logs --follow für Polling-DiagnosenAktualisieren; wenn Neustarts Fehlalarme sind, pollingStallThresholdMs anpassen. Anhaltende Hänger deuten weiterhin auf Proxy/DNS/IPv6 hin.
setMyCommands wird beim Start abgelehntLogs auf BOT_COMMANDS_TOO_MUCH prüfenPlugin-/Skills-/benutzerdefinierte Telegram-Befehle reduzieren oder native Menüs deaktivieren.
Aktualisiert und Zulassungsliste blockiert Sieopenclaw security audit und Konfigurations-Zulassungslistenopenclaw doctor --fix ausführen oder @username durch numerische Absender-IDs ersetzen.
Vollständige Fehlerbehebung: /channels/telegram#troubleshooting

Discord

Fehlersignaturen für Discord

SymptomSchnellste PrüfungKorrektur
Bot online, aber keine Antworten im Serveropenclaw channels status --probeServer/Kanal zulassen und Message-Content-Intent prüfen.
Gruppennachrichten werden ignoriertLogs auf durch Erwähnungsfilter verworfene Nachrichten prüfenBot erwähnen oder für Server/Kanal requireMention: false setzen.
DM-Antworten fehlenopenclaw pairing list discordDM-Kopplung freigeben oder DM-Richtlinie anpassen.
Vollständige Fehlerbehebung: /channels/discord#troubleshooting

Slack

Fehlersignaturen für Slack

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

iMessage und BlueBubbles

Fehlersignaturen für 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 freigeben oder Zulassungsliste aktualisieren.
Vollständige Fehlerbehebung:

Signal

Fehlersignaturen für 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 freigeben oder DM-Richtlinie anpassen.
Gruppenantworten werden nicht ausgelöstGruppen-Zulassungsliste und Erwähnungsmuster prüfenAbsender/Gruppe hinzufügen oder Einschränkungen lockern.
Vollständige Fehlerbehebung: /channels/signal#troubleshooting

QQ Bot

Fehlersignaturen für QQ Bot

SymptomSchnellste PrüfungKorrektur
Bot antwortet „gone to Mars“appId und clientSecret in der Konfiguration prüfenZugangsdaten setzen oder das Gateway neu starten.
Keine eingehenden Nachrichtenopenclaw channels status --probeZugangsdaten 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 anQQ-Plattformanforderungen für Interaktionen prüfenQQ blockiert möglicherweise botinitiierte Nachrichten ohne kürzliche Interaktion.
Vollständige Fehlerbehebung: /channels/qqbot#troubleshooting

Matrix

Fehlersignaturen für Matrix

SymptomSchnellste PrüfungKorrektur
Angemeldet, aber Raumnachrichten werden ignoriertopenclaw channels status --probegroupPolicy, Raum-Zulassungsliste und Erwähnungsfilter prüfen.
DMs werden nicht verarbeitetopenclaw pairing list matrixAbsender freigeben oder DM-Richtlinie anpassen.
Verschlüsselte Räume schlagen fehlopenclaw matrix verify statusGerät erneut verifizieren, dann openclaw matrix verify backup status prüfen.
Wiederherstellung des Backups ausstehend/defektopenclaw matrix verify backup statusopenclaw matrix verify backup restore ausführen oder mit einem Wiederherstellungsschlüssel erneut ausführen.
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