Configuration
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 der Reihe nach aus:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Gesunde Basis:
Runtime: runningConnectivity probe: okCapability: read-only,write-capableoderadmin-capable- Kanalprüfung zeigt, dass der Transport verbunden ist, und, sofern unterstützt,
worksoderaudit ok
WhatsApp-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Verbunden, aber keine DM-Antworten | openclaw pairing list whatsapp |
Sender genehmigen oder DM-Richtlinie/Allowlist ändern. |
| Gruppennachrichten werden ignoriert | requireMention + Erwähnungsmuster in der Konfiguration prüfen |
Bot erwähnen oder Erwähnungsrichtlinie für diese Gruppe lockern. |
| QR-Anmeldung läuft mit 408 ab | Gateway-Env HTTPS_PROXY / HTTP_PROXY prüfen |
Erreichbaren Proxy festlegen; NO_PROXY nur für Umgehungen verwenden. |
| Zufällige Trenn-/Neuanmeldeschleifen | openclaw channels status --probe + Logs |
Kürzliche Neuverbindungen werden markiert, auch wenn aktuell verbunden; Logs beobachten, Gateway neu starten und dann erneut verknüpfen, wenn das Flattern anhält. |
| Antworten treffen Sekunden/Minuten verspätet ein | openclaw doctor --fix |
Doctor stoppt verifiziert veraltete lokale TUI-Clients, wenn sie die Gateway-Ereignisschleife beeinträchtigen. |
Ausführliche Fehlerbehebung: WhatsApp-Fehlerbehebung
Telegram
Telegram-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
/start, aber kein nutzbarer Antwortfluss |
openclaw pairing list telegram |
Pairing genehmigen oder DM-Richtlinie ändern. |
| Bot online, aber Gruppe bleibt stumm | Erwähnungsanforderung und Bot-Privatsphärenmodus prüfen | Privatsphärenmodus für Gruppensichtbarkeit deaktivieren oder Bot erwähnen. |
| Sendefehler mit Netzwerkfehlern | Logs auf Fehler bei Telegram-API-Aufrufen prüfen | DNS-/IPv6-/Proxy-Routing zu api.telegram.org korrigieren. |
Start meldet getMe returned 401 |
Konfigurierte Token-Quelle prüfen | BotFather-Token erneut kopieren oder neu generieren und botToken, tokenFile oder das Standardkonto TELEGRAM_BOT_TOKEN aktualisieren. |
| Polling bleibt stehen oder verbindet sich langsam neu | openclaw logs --follow für Polling-Diagnosen |
Aktualisieren; wenn Neustarts falsch positive Ergebnisse sind, pollingStallThresholdMs anpassen. Dauerhafte Stillstände deuten weiterhin auf Proxy/DNS/IPv6 hin. |
setMyCommands beim Start abgelehnt |
Logs auf BOT_COMMANDS_TOO_MUCH prüfen |
Plugin-/Skill-/benutzerdefinierte Telegram-Befehle reduzieren oder native Menüs deaktivieren. |
| Aktualisiert und Allowlist blockiert Sie | openclaw security audit und Konfigurations-Allowlists |
openclaw doctor --fix ausführen oder @username durch numerische Sender-IDs ersetzen. |
Ausführliche Fehlerbehebung: Telegram-Fehlerbehebung
Discord
Discord-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Bot online, aber keine Guild-Antworten | openclaw channels status --probe |
Guild/Kanal erlauben und Message-Content-Intent prüfen. |
| Gruppennachrichten werden ignoriert | Logs auf verworfene Nachrichten durch Erwähnungs-Gating prüfen | Bot erwähnen oder für Guild/Kanal requireMention: false festlegen. |
| Tippen/Token-Nutzung, aber keine Discord-Nachricht | Sitzungslog zeigt Assistententext mit didSendViaMessagingTool: false |
Das Modell hat privat geantwortet, statt das Nachrichten-Tool aufzurufen. Verwenden Sie ein Modell, das Tool-Aufrufe zuverlässig ausführt, oder setzen Sie messages.groupChat.visibleReplies: "automatic", um automatisch zu posten. |
| DM-Antworten fehlen | openclaw pairing list discord |
DM-Pairing genehmigen oder DM-Richtlinie anpassen. |
Ausführliche Fehlerbehebung: Discord-Fehlerbehebung
Slack
Slack-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Socket Mode verbunden, aber keine Antworten | openclaw channels status --probe |
App-Token + Bot-Token und erforderliche Scopes prüfen; bei SecretRef-gestützten Setups auf botTokenStatus / appTokenStatus = configured_unavailable achten. |
| DMs blockiert | openclaw pairing list slack |
Pairing genehmigen oder DM-Richtlinie lockern. |
| Kanalnachricht ignoriert | groupPolicy und Kanal-Allowlist prüfen |
Kanal erlauben oder Richtlinie auf open umstellen. |
Ausführliche Fehlerbehebung: Slack-Fehlerbehebung
iMessage und BlueBubbles
iMessage- und BlueBubbles-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Keine eingehenden Ereignisse | Erreichbarkeit von Webhook/Server und App-Berechtigungen prüfen | Webhook-URL oder BlueBubbles-Serverstatus korrigieren. |
| Senden möglich, aber kein Empfang unter macOS | macOS-Datenschutzberechtigungen für Messages-Automatisierung prüfen | TCC-Berechtigungen erneut gewähren und Kanalprozess neu starten. |
| DM-Sender blockiert | openclaw pairing list imessage oder openclaw pairing list bluebubbles |
Pairing genehmigen oder Allowlist aktualisieren. |
Ausführliche Fehlerbehebung:
Signal
Signal-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Daemon erreichbar, aber Bot stumm | openclaw channels status --probe |
signal-cli-Daemon-URL/Konto und Empfangsmodus prüfen. |
| DM blockiert | openclaw pairing list signal |
Sender genehmigen oder DM-Richtlinie anpassen. |
| Gruppenantworten werden nicht ausgelöst | Gruppen-Allowlist und Erwähnungsmuster prüfen | Sender/Gruppe hinzufügen oder Gating lockern. |
Ausführliche Fehlerbehebung: Signal-Fehlerbehebung
QQ Bot
QQ Bot-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Bot antwortet „zum Mars verschwunden“ | appId und clientSecret in der Konfiguration prüfen |
Anmeldedaten festlegen oder Gateway neu starten. |
| Keine eingehenden Nachrichten | openclaw channels status --probe |
Anmeldedaten auf der QQ Open Platform prüfen. |
| Sprache wird nicht transkribiert | STT-Provider-Konfiguration prüfen | channels.qqbot.stt oder tools.media.audio konfigurieren. |
| Proaktive Nachrichten kommen nicht an | Interaktionsanforderungen der QQ-Plattform prüfen | QQ kann vom Bot initiierte Nachrichten ohne kürzliche Interaktion blockieren. |
Ausführliche Fehlerbehebung: QQ Bot-Fehlerbehebung
Matrix
Matrix-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Angemeldet, aber Raumnachrichten werden ignoriert | openclaw channels status --probe |
groupPolicy, Raum-Allowlist und Erwähnungs-Gating prüfen. |
| DMs werden nicht verarbeitet | openclaw pairing list matrix |
Sender genehmigen oder DM-Richtlinie anpassen. |
| Verschlüsselte Räume schlagen fehl | openclaw matrix verify status |
Gerät erneut verifizieren, dann openclaw matrix verify backup status prüfen. |
| Backup-Wiederherstellung steht aus/ist defekt | openclaw matrix verify backup status |
openclaw matrix verify backup restore ausführen oder mit einem Wiederherstellungsschlüssel erneut ausführen. |
| Cross-Signing/Bootstrap sieht falsch aus | openclaw matrix verify bootstrap |
Secret Storage, Cross-Signing und Backup-Status in einem Durchlauf reparieren. |
Vollständige Einrichtung und Konfiguration: Matrix