Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
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:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Runtime: runningConnectivity probe: okCapability: 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
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. |
Telegram
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. |
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. |
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. |
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. |
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. |
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. |
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. |
Verwandte Themen
