OpenClaw Kanal-Fehler beheben: Schnelle Diagnose-Anleitung

Du hast alles eingerichtet, die Verbindung steht, aber dein Bot ignoriert dich einfach? Das ist der klassische „Es sollte funktionieren, tut es aber nicht“-Moment, den jeder Entwickler hasst. Meistens liegt es an einer Kleinigkeit in der Konfiguration oder einer fehlenden Berechtigung, die den Nachrichtenfluss blockiert.

Diese Seite hilft dir dabei, das Problem einzugrenzen, wenn ein Channel zwar verbunden ist, sich aber falsch verhält.

Befehlskette

Führe diese Befehle zuerst in der angegebenen Reihenfolge aus:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Ein gesundes System sollte so aussehen:

Runtime: running
RPC probe: ok
Der Channel-Probe zeigt „connected/ready“

WhatsApp Fehlermuster

Symptom	Schnellster Check	Fix
Verbunden, aber keine DM-Antworten	`openclaw pairing list whatsapp`	Sender genehmigen oder DM-Policy/Allowlist ändern.
Gruppen-Nachrichten werden ignoriert	`requireMention` + Mention-Muster in der Config prüfen	Bot erwähnen (mention) oder Mention-Policy für diese Gruppe lockern.
Zufällige Disconnects/Relogin-Loops	`openclaw channels status --probe` + Logs	Erneut einloggen und prüfen, ob das Credentials-Verzeichnis intakt ist.

Vollständiges Troubleshooting: /channels/whatsapp#troubleshooting

Telegram Fehlermuster

Symptom	Schnellster Check	Fix
`/start` gesendet, aber kein Antwort-Flow	`openclaw pairing list telegram`	Pairing genehmigen oder DM-Policy ändern.
Bot ist online, aber Gruppe bleibt stumm	Mention-Anforderung und Bot Privacy Mode prüfen	Privacy Mode für Gruppen-Sichtbarkeit deaktivieren oder Bot erwähnen.
Sende-Fehler mit Netzwerkfehlern	Logs nach Telegram API Call-Fehlern durchsuchen	DNS/IPv6/Proxy-Routing zu `api.telegram.org` korrigieren.
`setMyCommands` beim Start abgelehnt	Logs nach `BOT_COMMANDS_TOO_MUCH` prüfen	Plugin/Skill/Custom Telegram Commands reduzieren oder native Menüs deaktivieren.
Upgrade durchgeführt und Allowlist blockiert dich	`openclaw security audit` und Config-Allowlists	`openclaw doctor --fix` ausführen oder `@username` durch numerische Sender-IDs ersetzen.

Vollständiges Troubleshooting: /channels/telegram#troubleshooting

Discord

Discord Fehlermuster

Symptom	Schnellster Check	Fix
Bot online, aber keine Antworten auf Servern	`openclaw channels status --probe`	Server/Channel erlauben und Message Content Intent verifizieren.
Gruppen-Nachrichten werden ignoriert	Logs nach Drops durch Mention-Gating prüfen	Bot erwähnen oder für Server/Channel `requireMention: false` setzen.
DM-Antworten fehlen	`openclaw pairing list discord`	DM-Pairing genehmigen oder DM-Policy anpassen.

Vollständiges Troubleshooting: /channels/discord#troubleshooting

Slack

Slack Fehlermuster

Symptom	Schnellster Check	Fix
Socket Mode verbunden, aber keine Reaktionen	`openclaw channels status --probe`	App Token + Bot Token und benötigte Scopes prüfen.
DMs blockiert	`openclaw pairing list slack`	Pairing genehmigen oder DM-Policy lockern.
Channel-Nachricht ignoriert	`groupPolicy` und Channel-Allowlist prüfen	Channel erlauben oder Policy auf `open` setzen.

Vollständiges Troubleshooting: /channels/slack#troubleshooting

iMessage und BlueBubbles

iMessage und BlueBubbles Fehlermuster

Symptom	Schnellster Check	Fix
Keine eingehenden Events	Webhook/Server-Erreichbarkeit und App-Berechtigungen prüfen	Webhook-URL oder BlueBubbles Server-Status korrigieren.
Senden klappt, aber kein Empfang auf macOS	macOS Datenschutz-Einstellungen für Messages Automation prüfen	TCC-Berechtigungen erneut erteilen und Channel-Prozess neu starten.
DM-Sender blockiert	`openclaw pairing list imessage` oder `openclaw pairing list bluebubbles`	Pairing genehmigen oder Allowlist aktualisieren.

Vollständiges Troubleshooting:

Signal

Signal Fehlermuster

Symptom	Schnellster Check	Fix
Daemon erreichbar, aber Bot bleibt stumm	`openclaw channels status --probe`	`signal-cli` Daemon-URL/Account und Receive-Mode prüfen.
DM blockiert	`openclaw pairing list signal`	Sender genehmigen oder DM-Policy anpassen.
Gruppen-Antworten triggern nicht	Gruppen-Allowlist und Mention-Muster prüfen	Sender/Gruppe hinzufügen oder Gating lockern.

Vollständiges Troubleshooting: /channels/signal#troubleshooting

QQ Bot

QQ Bot Fehlermuster

Symptom	Schnellster Check	Fix
Bot antwortet „gone to Mars“	`appId` und `clientSecret` in der Config prüfen	Credentials setzen oder Gateway neu starten.
Keine eingehenden Nachrichten	`openclaw channels status --probe`	Credentials auf der QQ Open Platform verifizieren.
Sprache wird nicht transkribiert	STT-Provider-Config prüfen	`channels.qqbot.stt` oder `tools.media.audio` konfigurieren.
Proaktive Nachrichten kommen nicht an	QQ Platform Interaktions-Anforderungen prüfen	QQ blockiert evtl. vom Bot initiierte Nachrichten ohne kürzliche Interaktion.

Vollständiges Troubleshooting: /channels/qqbot#troubleshooting

Matrix

Matrix Fehlermuster

Symptom	Schnellster Check	Fix
Eingeloggt, aber ignoriert Raum-Nachrichten	`openclaw channels status --probe`	`groupPolicy` und Raum-Allowlist prüfen.
DMs werden nicht verarbeitet	`openclaw pairing list matrix`	Sender genehmigen oder DM-Policy anpassen.
Verschlüsselte Räume schlagen fehl	Crypto-Modul und Verschlüsselungs-Einstellungen prüfen	Verschlüsselungs-Support aktivieren und Raum neu betreten/syncen.

Vollständiges Setup und Konfiguration: Matrix

Brauchst du Hilfe bei der Einrichtung? Frag den AI Setup Assistant.

Nächste Schritte

OpenClaw Expert

Noch festgefahren?

Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.