Configuration

Fehlerbehebung für Kanäle

Verwenden Sie diese Seite, wenn ein Kanal eine Verbindung herstellt, sich aber nicht wie erwartet verhält.

Befehlsabfolge

Führen Sie zunächst diese Befehle der Reihe nach aus:

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Fehlerfreier Ausgangszustand:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable oder admin-capable
Die Kanalprüfung zeigt, dass der Transport verbunden ist und, sofern unterstützt, works oder audit ok

Nach einer Aktualisierung

Verwenden Sie diese Schritte, wenn Telegram, iMessage, Konfigurationen aus der BlueBubbles-Ära oder ein anderer Plugin-Kanal nach einer Aktualisierung nicht mehr verfügbar ist.

bash

openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --all

Suchen Sie in openclaw status --all nach plugin load failed: dependency tree corrupted; run openclaw doctor --fix. Dies bedeutet, dass der Kanal konfiguriert ist, die Einrichtung oder das Laden des Plugins jedoch aufgrund eines beschädigten Abhängigkeitsbaums fehlgeschlagen ist, statt den Kanal zu registrieren. openclaw doctor --fix entfernt veraltete symbolische Abhängigkeitsverknüpfungen der Plugin-Laufzeit und veraltete Authentifizierungsschatten. Anschließend lädt openclaw gateway restart einen bereinigten Zustand neu.

WhatsApp-Fehlersymptome

Symptom	Schnellste Prüfung	Behebung
Verbunden, aber keine Antworten auf Direktnachrichten	`openclaw pairing list whatsapp`	Genehmigen Sie den Absender oder ändern Sie die Richtlinie beziehungsweise Zulassungsliste für Direktnachrichten.
Gruppennachrichten werden ignoriert	Prüfen Sie `requireMention` und Erwähnungsmuster in der Konfiguration	Erwähnen Sie den Bot oder lockern Sie die Erwähnungsrichtlinie für diese Gruppe.
QR-Anmeldung läuft mit 408 ab	Prüfen Sie die Gateway-Umgebungsvariablen `HTTPS_PROXY` / `HTTP_PROXY`	Legen Sie einen erreichbaren Proxy fest; verwenden Sie `NO_PROXY` nur für Umgehungen.
Zufällige Trennungs-/Neuanmeldeschleifen	`openclaw channels status --probe` und Protokolle	Kürzliche Neuverbindungen werden auch bei aktuell bestehender Verbindung gekennzeichnet; beobachten Sie die Protokolle, starten Sie das Gateway neu und verknüpfen Sie das Konto erneut, falls die Verbindung weiterhin instabil ist.
Schleife mit `status=408 Request Time-out`	Prüfung, Protokolle, Doctor und anschließend Gateway-Status	Beheben Sie zuerst Verbindungs- oder Zeitsteuerungsprobleme des Hosts; sichern Sie die Authentifizierungsdaten und verknüpfen Sie das Konto erneut, falls die Schleife bestehen bleibt.
Antworten treffen Sekunden oder Minuten verspätet ein	`openclaw doctor --fix`	Doctor beendet nachweislich veraltete lokale TUI-Clients, wenn diese die Gateway-Ereignisschleife beeinträchtigen.

Vollständige Fehlerbehebung: WhatsApp-Fehlerbehebung

Telegram-Fehlersymptome

Symptom	Schnellste Prüfung	Behebung
`/start`, aber kein nutzbarer Antwortablauf	`openclaw pairing list telegram`	Genehmigen Sie die Kopplung oder ändern Sie die Richtlinie für Direktnachrichten.
Bot ist online, aber die Gruppe bleibt stumm	Prüfen Sie die Anforderung einer Erwähnung und den Datenschutzmodus des Bots	Deaktivieren Sie den Datenschutzmodus, damit Gruppennachrichten sichtbar sind, oder erwähnen Sie den Bot.
Sendefehler mit Netzwerkfehlern	Prüfen Sie die Protokolle auf fehlgeschlagene Telegram-API-Aufrufe	Korrigieren Sie die DNS-/IPv6-/Proxy-Weiterleitung zu `api.telegram.org`.
Beim Start wird `getMe returned 401` gemeldet	Prüfen Sie die konfigurierte Token-Quelle	Kopieren oder erzeugen Sie das BotFather-Token erneut und aktualisieren Sie `botToken`, `tokenFile` oder `TELEGRAM_BOT_TOKEN` des Standardkontos.
Polling bleibt hängen oder stellt die Verbindung nur langsam wieder her	Prüfen Sie `openclaw logs --follow` auf Polling-Diagnosen	Aktualisieren Sie OpenClaw; falls Neustarts fälschlich erkannt werden, passen Sie `pollingStallThresholdMs` an. Anhaltende Aussetzer weisen weiterhin auf Proxy-, DNS- oder IPv6-Probleme hin.
`setMyCommands` wird beim Start abgelehnt	Prüfen Sie die Protokolle auf `BOT_COMMANDS_TOO_MUCH`	Reduzieren Sie Plugin-, Skill- oder benutzerdefinierte Telegram-Befehle oder deaktivieren Sie native Menüs.
Nach der Aktualisierung werden Sie von der Zulassungsliste blockiert	`openclaw security audit` und Zulassungslisten der Konfiguration	Führen Sie `openclaw doctor --fix` aus oder ersetzen Sie `@username` durch numerische Absender-IDs.

Vollständige Fehlerbehebung: Telegram-Fehlerbehebung

Discord

Discord-Fehlersymptome

Symptom	Schnellste Prüfung	Behebung
Bot ist online, antwortet aber nicht in der Community	`openclaw channels status --probe`	Lassen Sie die Community beziehungsweise den Kanal zu und prüfen Sie den Intent für Nachrichteninhalte.
Gruppennachrichten werden ignoriert	Prüfen Sie die Protokolle auf aufgrund der Erwähnungsbeschränkung verworfene Nachrichten	Erwähnen Sie den Bot oder setzen Sie für die Community beziehungsweise den Kanal `requireMention: false`.
Eingabe-/Token-Nutzung, aber keine Discord-Nachricht	Prüfen Sie, ob es sich um ein Ereignis eines Umgebungskanals oder einen ausdrücklich aktivierten `message_tool`-Kanal handelt, in dem das Modell `message(action=send)` ausgelassen hat	Prüfen Sie das ausführliche Gateway-Protokoll auf Metadaten unterdrückter endgültiger Nutzlasten, überprüfen Sie `messages.groupChat.unmentionedInbound`, lesen Sie Ereignisse in Umgebungskanälen oder behalten Sie für normale Gruppenanfragen `messages.groupChat.visibleReplies: "automatic"` bei.
Antworten auf Direktnachrichten fehlen	`openclaw pairing list discord`	Genehmigen Sie die Kopplung für Direktnachrichten oder passen Sie die Richtlinie für Direktnachrichten an.

Vollständige Fehlerbehebung: Discord-Fehlerbehebung

Slack

Slack-Fehlersymptome

Symptom	Schnellste Prüfung	Behebung
Socket-Modus verbunden, aber keine Antworten	`openclaw channels status --probe`	Prüfen Sie App-Token, Bot-Token und erforderliche Berechtigungsbereiche; achten Sie bei SecretRef-basierten Einrichtungen auf `botTokenStatus` / `appTokenStatus = configured_unavailable`.
Direktnachrichten werden blockiert	`openclaw pairing list slack`	Genehmigen Sie die Kopplung oder lockern Sie die Richtlinie für Direktnachrichten.
Kanalnachricht wird ignoriert	Prüfen Sie `groupPolicy` und die Kanal-Zulassungsliste	Lassen Sie den Kanal zu oder ändern Sie die Richtlinie in `open`.

Vollständige Fehlerbehebung: Slack-Fehlerbehebung

iMessage

iMessage-Fehlersymptome

Symptom	Schnellste Prüfung	Behebung
`imsg` fehlt oder schlägt außerhalb von macOS fehl	`openclaw channels status --probe --channel imessage`	Führen Sie OpenClaw auf dem Mac mit Messages aus oder verwenden Sie einen SSH-Wrapper für `cliPath`.
Senden funktioniert, Empfangen unter macOS jedoch nicht	Prüfen Sie die macOS-Datenschutzberechtigungen für die Messages-Automatisierung	Erteilen Sie die TCC-Berechtigungen erneut und starten Sie den Kanalprozess neu.
Absender einer Direktnachricht wird blockiert	`openclaw pairing list imessage`	Genehmigen Sie die Kopplung oder aktualisieren Sie die Zulassungsliste.

Vollständige Fehlerbehebung: iMessage-Fehlerbehebung

Signal

Signal-Fehlersymptome

Symptom	Schnellste Prüfung	Behebung
Daemon erreichbar, aber Bot stumm	`openclaw channels status --probe`	Prüfen Sie die Daemon-URL beziehungsweise das Konto von `signal-cli` und den Empfangsmodus.
Direktnachricht blockiert	`openclaw pairing list signal`	Genehmigen Sie den Absender oder passen Sie die Richtlinie für Direktnachrichten an.
Gruppenantworten werden nicht ausgelöst	Prüfen Sie die Gruppen-Zulassungsliste und Erwähnungsmuster	Fügen Sie den Absender beziehungsweise die Gruppe hinzu oder lockern Sie die Beschränkung.

Vollständige Fehlerbehebung: Signal-Fehlerbehebung

QQ Bot

QQ-Bot-Fehlersymptome

Symptom	Schnellste Prüfung	Behebung
Bot antwortet mit „zum Mars geflogen“	Prüfen Sie `appId` und `clientSecret` in der Konfiguration	Legen Sie die Anmeldedaten fest oder starten Sie das Gateway neu.
Keine eingehenden Nachrichten	`openclaw channels status --probe`	Prüfen Sie die Anmeldedaten auf der QQ Open Platform.
Sprache wird nicht transkribiert	Prüfen Sie die Konfiguration des STT-Providers	Konfigurieren Sie `channels.qqbot.stt` oder `tools.media.audio`.
Proaktive Nachrichten kommen nicht an	Prüfen Sie die Interaktionsanforderungen der QQ-Plattform	QQ blockiert möglicherweise vom Bot initiierte Nachrichten, wenn kürzlich keine Interaktion stattgefunden hat.

Vollständige Fehlerbehebung: QQ-Bot-Fehlerbehebung

Matrix

Matrix-Fehlersignaturen

Symptom	Schnellste Prüfung	Behebung
Angemeldet, aber Raumnachrichten werden ignoriert	`openclaw channels status --probe`	Prüfen Sie `groupPolicy`, die Raum-Zulassungsliste und die Erwähnungssteuerung.
Direktnachrichten werden nicht verarbeitet	`openclaw pairing list matrix`	Genehmigen Sie den Absender oder passen Sie die Richtlinie für Direktnachrichten an.
Verschlüsselte Räume funktionieren nicht	`openclaw matrix verify status`	Verifizieren Sie das Gerät erneut und prüfen Sie dann `openclaw matrix verify backup status`.
Backup-Wiederherstellung steht aus oder ist defekt	`openclaw matrix verify backup status`	Führen Sie `openclaw matrix verify backup restore` aus oder wiederholen Sie den Vorgang mit einem Wiederherstellungsschlüssel.
Cross-Signing/Bootstrap sieht fehlerhaft aus	`openclaw matrix verify bootstrap`	Reparieren Sie Secret Storage, Cross-Signing und den Backup-Status in einem Durchlauf.

Vollständige Einrichtung und Konfiguration: Matrix