Befehlsleiter
Führen Sie diese zuerst der Reihe nach aus:Runtime: runningConnectivity probe: okCapability: read-only,write-capableoderadmin-capable- Die Kanalprüfung zeigt, dass der Transport verbunden ist und, sofern unterstützt,
worksoderaudit ok
Nach einem Update
Verwenden Sie dies, wenn Telegram, iMessage, Konfigurationen aus der BlueBubbles-Ära oder ein anderer Plugin-Kanal nach dem Update verschwindet.plugin load failed: dependency tree corrupted; run openclaw doctor --fix in openclaw status --all. Das bedeutet, dass der Kanal konfiguriert ist, aber der Einrichtungs-/Ladepfad des Plugins auf einen beschädigten Abhängigkeitsbaum gestoßen ist, statt den Kanal zu registrieren. openclaw doctor --fix entfernt veraltete Plugin-Abhängigkeits-Staging-Verzeichnisse und veraltete Authentifizierungsschatten; anschließend lädt openclaw gateway restart den bereinigten Zustand neu.
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/Zulassungsliste. |
| Gruppennachrichten werden ignoriert | requireMention + Erwähnungsmuster in der Konfiguration prüfen | Erwähnen Sie den Bot oder lockern Sie die Erwähnungsrichtlinie für diese Gruppe. |
| QR-Anmeldung läuft mit 408 ab | Gateway-Umgebung HTTPS_PROXY / HTTP_PROXY prüfen | 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 Neuverbindungen werden markiert, auch wenn aktuell eine Verbindung besteht; beobachten Sie die Logs, starten Sie das Gateway neu und verknüpfen Sie erneut, wenn das Flattern anhält. |
status=408 Request Time-out-Schleife | Prüfung, Logs, Doctor, dann Gateway-Status | Beheben Sie zuerst Host-Konnektivität/Timing; sichern Sie die Authentifizierung und verknüpfen Sie das Konto erneut, wenn die Schleife bestehen bleibt. |
| Antworten kommen Sekunden/Minuten verspätet an | openclaw doctor --fix | Doctor stoppt verifizierte veraltete lokale TUI-Clients, wenn sie die Gateway-Ereignisschleife beeinträchtigen. |
Telegram
Telegram-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
/start, aber kein nutzbarer Antwortfluss | openclaw pairing list telegram | Genehmigen Sie die Kopplung oder ändern Sie die DM-Richtlinie. |
| Bot online, aber Gruppe bleibt stumm | Erwähnungsanforderung und Bot-Privatsphärenmodus prüfen | Deaktivieren Sie den Privatsphärenmodus für Gruppensichtbarkeit oder erwähnen Sie den Bot. |
| Sendefehler mit Netzwerkfehlern | Logs auf Fehler bei Telegram-API-Aufrufen prüfen | Beheben Sie DNS-/IPv6-/Proxy-Routing zu api.telegram.org. |
Start meldet getMe returned 401 | Konfigurierte Token-Quelle prüfen | Kopieren oder erzeugen Sie das BotFather-Token erneut und aktualisieren Sie botToken, tokenFile oder das Standardkonto TELEGRAM_BOT_TOKEN. |
| Polling stockt oder verbindet langsam neu | openclaw logs --follow für Polling-Diagnosen | Aktualisieren Sie; wenn Neustarts Fehlalarme sind, passen Sie pollingStallThresholdMs an. Dauerhafte Stockungen deuten weiterhin auf Proxy/DNS/IPv6 hin. |
setMyCommands wird beim Start abgelehnt | Logs auf BOT_COMMANDS_TOO_MUCH prüfen | Reduzieren Sie Plugin-/Skill-/benutzerdefinierte Telegram-Befehle oder deaktivieren Sie native Menüs. |
| Nach Upgrade blockiert Sie die Zulassungsliste | openclaw security audit und Konfigurations-Zulassungslisten | Führen Sie openclaw doctor --fix aus oder ersetzen Sie @username durch numerische Absender-IDs. |
Discord
Discord-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Bot online, aber keine Guild-Antworten | openclaw channels status --probe | Erlauben Sie Guild/Kanal und verifizieren Sie die Message-Content-Intent. |
| Gruppennachrichten werden ignoriert | Logs auf verworfene Nachrichten durch Erwähnungs-Gating prüfen | Erwähnen Sie den Bot oder setzen Sie für Guild/Kanal requireMention: false. |
| Tipp-/Token-Nutzung, aber keine Discord-Nachricht | Prüfen Sie, ob dies ein Ambient-Room-Ereignis oder ein abonnierter message_tool-Raum ist, in dem das Modell message(action=send) verpasst hat | Prüfen Sie das ausführliche Gateway-Log auf unterdrückte finale Payload-Metadaten, verifizieren Sie messages.groupChat.unmentionedInbound, lesen Sie Ambient-Room-Ereignisse oder behalten Sie messages.groupChat.visibleReplies: "automatic" für normale Gruppenanfragen bei. |
| DM-Antworten fehlen | openclaw pairing list discord | Genehmigen Sie die DM-Kopplung oder passen Sie die DM-Richtlinie an. |
Slack
Slack-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Socket-Modus verbunden, aber keine Antworten | openclaw channels status --probe | Verifizieren 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 die Kopplung oder lockern Sie die DM-Richtlinie. |
| Kanalnachricht ignoriert | groupPolicy und Kanal-Zulassungsliste prüfen | Erlauben Sie den Kanal oder ändern Sie die Richtlinie zu open. |
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 unter macOS | macOS-Datenschutzberechtigungen für Messages-Automation prüfen | Gewähren Sie TCC-Berechtigungen erneut und starten Sie den Kanalprozess neu. |
| DM-Absender blockiert | openclaw pairing list imessage | Genehmigen Sie die Kopplung oder aktualisieren Sie die Zulassungsliste. |
Signal
Signal-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Daemon erreichbar, aber Bot stumm | openclaw channels status --probe | Verifizieren 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 | Gruppen-Zulassungsliste und Erwähnungsmuster prüfen | Fügen Sie Absender/Gruppe hinzu oder lockern Sie das Gating. |
QQ Bot
QQ Bot-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Bot antwortet „zum Mars verschwunden“ | appId und clientSecret in der Konfiguration verifizieren | Legen Sie Anmeldedaten fest oder starten Sie das Gateway neu. |
| Keine eingehenden Nachrichten | openclaw channels status --probe | Verifizieren Sie die Anmeldedaten auf der QQ Open Platform. |
| Sprache wird nicht transkribiert | STT-Provider-Konfiguration prüfen | Konfigurieren Sie channels.qqbot.stt oder tools.media.audio. |
| Proaktive Nachrichten kommen nicht an | Interaktionsanforderungen der QQ-Plattform prüfen | QQ kann vom Bot initiierte Nachrichten ohne kürzliche Interaktion blockieren. |
Matrix
Matrix-Fehlersignaturen
| Symptom | Schnellste Prüfung | Behebung |
|---|---|---|
| Angemeldet, ignoriert aber Raumnachrichten | openclaw channels status --probe | Prüfen Sie groupPolicy, Raum-Allowlist und Mention-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 dann openclaw matrix verify backup status. |
| Backup-Wiederherstellung wartet/ist 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. |