Configuration

Fehlerbehebung für Kanäle

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

Befehlskette

Führen Sie diese zuerst der Reihe nach aus:

bash

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

Fehlerfreie Ausgangsbasis:

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

WhatsApp-Fehlersignaturen

Symptom	Schnellste Prüfung	Behebung
Verbunden, aber keine DM-Antworten	`openclaw pairing list whatsapp`	Genehmigen Sie den Absender oder ändern Sie die DM-Richtlinie/Allowlist.
Gruppennachrichten werden ignoriert	Prüfen Sie `requireMention` + 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-Umgebung `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` + Logs	Kürzliche Wiederverbindungen werden auch dann markiert, wenn aktuell eine Verbindung besteht; beobachten Sie die Logs, starten Sie den Gateway neu und verknüpfen Sie erneut, wenn das Flapping anhält.
Antworten kommen Sekunden/Minuten verspätet an	`openclaw doctor --fix`	Doctor stoppt verifiziert veraltete lokale TUI-Clients, wenn sie die Gateway-Ereignisschleife beeinträchtigen.

Vollständige Fehlerbehebung: WhatsApp-Fehlerbehebung

Telegram-Fehlersignaturen

Symptom	Schnellste Prüfung	Behebung
`/start`, aber kein nutzbarer Antwortfluss	`openclaw pairing list telegram`	Genehmigen Sie das Pairing oder ändern Sie die DM-Richtlinie.
Bot online, aber Gruppe bleibt still	Prüfen Sie die Erwähnungsanforderung und den Datenschutzmodus des Bots	Deaktivieren Sie den Datenschutzmodus für Gruppensichtbarkeit oder erwähnen Sie den Bot.
Sendefehler mit Netzwerkfehlern	Prüfen Sie Logs auf Fehler bei Telegram-API-Aufrufen	Beheben Sie DNS-/IPv6-/Proxy-Routing zu `api.telegram.org`.
Start meldet `getMe returned 401`	Prüfen Sie die konfigurierte Token-Quelle	Kopieren oder erzeugen Sie das BotFather-Token erneut und aktualisieren Sie `botToken`, `tokenFile` oder das Standardkonto `TELEGRAM_BOT_TOKEN`.
Polling bleibt hängen oder verbindet sich langsam neu	`openclaw logs --follow` für Polling-Diagnosen	Aktualisieren Sie; wenn Neustarts False Positives sind, passen Sie `pollingStallThresholdMs` an. Dauerhafte Hänger deuten weiterhin auf Proxy/DNS/IPv6 hin.
`setMyCommands` wird beim Start abgelehnt	Prüfen Sie Logs auf `BOT_COMMANDS_TOO_MUCH`	Reduzieren Sie Plugin-/Skill-/benutzerdefinierte Telegram-Befehle oder deaktivieren Sie native Menüs.
Nach Upgrade blockiert Sie die Allowlist	`openclaw security audit` und Konfigurations-Allowlists	Führen Sie `openclaw doctor --fix` aus oder ersetzen Sie `@username` durch numerische Absender-IDs.

Vollständige Fehlerbehebung: Telegram-Fehlerbehebung

Discord

Discord-Fehlersignaturen

Symptom	Schnellste Prüfung	Behebung
Bot online, aber keine Guild-Antworten	`openclaw channels status --probe`	Erlauben Sie Guild/Kanal und prüfen Sie den Message-Content-Intent.
Gruppennachrichten werden ignoriert	Prüfen Sie Logs auf verworfene Nachrichten durch Erwähnungs-Gating	Erwähnen Sie den Bot oder setzen Sie `requireMention: false` für Guild/Kanal.
Tipp-/Token-Nutzung, aber keine Discord-Nachricht	Sitzungslog zeigt Assistententext mit `didSendViaMessagingTool: false`	Das Modell hat privat geantwortet, statt das Nachrichtentool aufzurufen. Verwenden Sie ein Modell mit zuverlässigen Tool-Aufrufen oder setzen Sie `messages.groupChat.visibleReplies: "automatic"` für automatisches Posten.
DM-Antworten fehlen	`openclaw pairing list discord`	Genehmigen Sie das DM-Pairing oder passen Sie die DM-Richtlinie an.

Vollständige Fehlerbehebung: Discord-Fehlerbehebung

Slack

Slack-Fehlersignaturen

Symptom	Schnellste Prüfung	Behebung
Socket-Modus verbunden, aber keine Antworten	`openclaw channels status --probe`	Prüfen Sie App-Token + Bot-Token und erforderliche Scopes; achten Sie bei SecretRef-gestützten Setups auf `botTokenStatus` / `appTokenStatus = configured_unavailable`.
DMs blockiert	`openclaw pairing list slack`	Genehmigen Sie das Pairing oder lockern Sie die DM-Richtlinie.
Kanalnachricht wird ignoriert	Prüfen Sie `groupPolicy` und Kanal-Allowlist	Erlauben Sie den Kanal oder ändern Sie die Richtlinie auf `open`.

Vollständige Fehlerbehebung: Slack-Fehlerbehebung

iMessage

iMessage-Fehlersignaturen

Symptom	Schnellste Prüfung	Behebung
`imsg` fehlt oder schlägt auf Nicht-macOS fehl	`openclaw channels status --probe --channel imessage`	Führen Sie OpenClaw auf dem Messages-Mac aus oder verwenden Sie einen SSH-Wrapper für `cliPath`.
Senden möglich, aber kein Empfang auf macOS	Prüfen Sie macOS-Datenschutzberechtigungen für Messages-Automatisierung	Erteilen Sie TCC-Berechtigungen erneut und starten Sie den Kanalprozess neu.
DM-Absender blockiert	`openclaw pairing list imessage`	Genehmigen Sie das Pairing oder aktualisieren Sie die Allowlist.

Vollständige Fehlerbehebung:

iMessage-Fehlerbehebung

Signal

Signal-Fehlersignaturen

Symptom	Schnellste Prüfung	Behebung
Daemon erreichbar, aber Bot still	`openclaw channels status --probe`	Prüfen Sie `signal-cli`-Daemon-URL/Konto und Empfangsmodus.
DM blockiert	`openclaw pairing list signal`	Genehmigen Sie den Absender oder passen Sie die DM-Richtlinie an.
Gruppenantworten werden nicht ausgelöst	Prüfen Sie Gruppen-Allowlist und Erwähnungsmuster	Fügen Sie Absender/Gruppe hinzu oder lockern Sie das Gating.

Vollständige Fehlerbehebung: Signal-Fehlerbehebung

QQ Bot

QQ Bot-Fehlersignaturen

Symptom	Schnellste Prüfung	Behebung
Bot antwortet „gone to Mars“	Prüfen Sie `appId` und `clientSecret` in der Konfiguration	Legen Sie Zugangsdaten fest oder starten Sie den Gateway neu.
Keine eingehenden Nachrichten	`openclaw channels status --probe`	Prüfen Sie die Zugangsdaten auf der QQ Open Platform.
Sprache wird nicht transkribiert	Prüfen Sie die STT-Provider-Konfiguration	Konfigurieren Sie `channels.qqbot.stt` oder `tools.media.audio`.
Proaktive Nachrichten kommen nicht an	Prüfen Sie die Interaktionsanforderungen der QQ-Plattform	QQ kann vom Bot initiierte Nachrichten ohne kürzliche Interaktion blockieren.

Vollständige Fehlerbehebung: QQ Bot-Fehlerbehebung

Matrix

Matrix-Fehlersignaturen

Symptom	Schnellste Prüfung	Behebung
Angemeldet, aber ignoriert Raumnachrichten	`openclaw channels status --probe`	Prüfen Sie `groupPolicy`, Raum-Allowlist und Erwähnungs-Gating.
DMs werden nicht verarbeitet	`openclaw pairing list matrix`	Genehmigen Sie den Absender oder passen Sie die DM-Richtlinie an.
Verschlüsselte Räume schlagen fehl	`openclaw matrix verify status`	Verifizieren Sie das Gerät erneut und prüfen Sie anschließend `openclaw matrix verify backup status`.
Backup-Wiederherstellung ist ausstehend/defekt	`openclaw matrix verify backup status`	Führen Sie `openclaw matrix verify backup restore` aus oder starten Sie erneut mit einem Wiederherstellungsschlüssel.
Cross-Signing/Bootstrap sieht falsch aus	`openclaw matrix verify bootstrap`	Reparieren Sie Secret Storage, Cross-Signing und Backup-Status in einem Durchlauf.

Vollständige Einrichtung und Konfiguration: Matrix