Configuration

Probleemoplossing voor kanalen

Gebruik deze pagina wanneer een kanaal verbinding maakt, maar het gedrag niet correct is.

Commandoreeks

Voer eerst deze opdrachten in deze volgorde uit:

bash

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

Gezonde uitgangssituatie:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable of admin-capable
De kanaalcontrole toont dat het transport verbonden is en, waar ondersteund, works of audit ok

Na een update

Gebruik dit wanneer Telegram, iMessage, configuraties uit het BlueBubbles-tijdperk of een ander pluginkanaal na een update verdwijnt.

bash

openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --all

Zoek naar plugin load failed: dependency tree corrupted; run openclaw doctor --fix in openclaw status --all. Dit betekent dat het kanaal is geconfigureerd, maar dat tijdens het instellen of laden van de plugin een beschadigde afhankelijkheidsstructuur is aangetroffen in plaats van dat het kanaal is geregistreerd. openclaw doctor --fix verwijdert verouderde symbolische koppelingen voor afhankelijkheden van de pluginruntime en verouderde authenticatieschaduwen, waarna openclaw gateway restart de opgeschoonde status opnieuw laadt.

WhatsApp-foutsignaturen

Symptoom	Snelste controle	Oplossing
Verbonden, maar geen antwoorden op privéberichten	`openclaw pairing list whatsapp`	Keur de afzender goed of wijzig het beleid/de toegestane lijst voor privéberichten.
Groepsberichten worden genegeerd	Controleer `requireMention` en vermeldingspatronen in de configuratie	Vermeld de bot of versoepel het vermeldingsbeleid voor die groep.
QR-aanmelding verloopt met 408	Controleer de Gateway-omgevingsvariabelen `HTTPS_PROXY` / `HTTP_PROXY`	Stel een bereikbare proxy in; gebruik `NO_PROXY` alleen voor omzeilingen.
Willekeurige verbreek-/heraanmeldingslussen	`openclaw channels status --probe` en logboeken	Recente nieuwe verbindingen worden gemarkeerd, zelfs wanneer er momenteel verbinding is; houd de logboeken in de gaten, herstart de Gateway en koppel opnieuw als de instabiliteit aanhoudt.
Lus met `status=408 Request Time-out`	Controle, logboeken, doctor en vervolgens Gateway-status	Herstel eerst de connectiviteit/timing van de host; maak een back-up van de authenticatie en koppel het account opnieuw als de lus aanhoudt.
Antwoorden komen seconden/minuten te laat aan	`openclaw doctor --fix`	Doctor stopt geverifieerde verouderde lokale TUI-clients wanneer deze de gebeurtenislus van de Gateway verslechteren.

Volledige probleemoplossing: Probleemoplossing voor WhatsApp

Telegram-foutsignaturen

Symptoom	Snelste controle	Oplossing
`/start`, maar geen bruikbare antwoordstroom	`openclaw pairing list telegram`	Keur de koppeling goed of wijzig het beleid voor privéberichten.
Bot is online, maar de groep blijft stil	Controleer de vermeldingsvereiste en privacymodus van de bot	Schakel de privacymodus uit voor zichtbaarheid in groepen of vermeld de bot.
Verzendfouten met netwerkfouten	Controleer logboeken op mislukte Telegram-API-aanroepen	Herstel DNS-/IPv6-/proxyrouting naar `api.telegram.org`.
Bij opstarten wordt `getMe returned 401` gemeld	Controleer de geconfigureerde tokenbron	Kopieer het BotFather-token opnieuw of genereer het opnieuw en werk `botToken`, `tokenFile` of `TELEGRAM_BOT_TOKEN` van het standaardaccount bij.
Polling loopt vast of maakt langzaam opnieuw verbinding	Gebruik `openclaw logs --follow` voor pollingdiagnostiek	Voer een upgrade uit; als herstarts fout-positieven zijn, stel `pollingStallThresholdMs` af. Aanhoudende blokkades wijzen nog steeds op proxy/DNS/IPv6.
`setMyCommands` wordt bij het opstarten geweigerd	Controleer logboeken op `BOT_COMMANDS_TOO_MUCH`	Verminder plugin-/skill-/aangepaste Telegram-opdrachten of schakel systeemeigen menu's uit.
Na upgrade wordt u door de toegestane lijst geblokkeerd	`openclaw security audit` en toegestane lijsten in de configuratie	Voer `openclaw doctor --fix` uit of vervang `@username` door numerieke afzender-ID's.

Volledige probleemoplossing: Probleemoplossing voor Telegram

Discord

Discord-foutsignaturen

Symptoom	Snelste controle	Oplossing
Bot is online, maar antwoordt niet in de server	`openclaw channels status --probe`	Sta de server/het kanaal toe en controleer de intentie voor berichtinhoud.
Groepsberichten worden genegeerd	Controleer de logboeken op berichten die door de vermeldingsfilter zijn tegengehouden	Vermeld de bot of stel voor de server/het kanaal `requireMention: false` in.
Typ-/tokengebruik, maar geen Discord-bericht	Controleer of dit een gebeurtenis in een omgevingsruimte is of een aangemelde `message_tool`-ruimte waarin het model `message(action=send)` heeft gemist	Controleer het uitgebreide Gateway-logboek op metadata van onderdrukte definitieve payloads, verifieer `messages.groupChat.unmentionedInbound`, lees Gebeurtenissen in omgevingsruimten of behoud `messages.groupChat.visibleReplies: "automatic"` voor normale groepsverzoeken.
Antwoorden op privéberichten ontbreken	`openclaw pairing list discord`	Keur de koppeling voor privéberichten goed of pas het beleid voor privéberichten aan.

Volledige probleemoplossing: Probleemoplossing voor Discord

Slack

Slack-foutsignaturen

Symptoom	Snelste controle	Oplossing
Socketmodus is verbonden, maar geen antwoorden	`openclaw channels status --probe`	Controleer het app-token, het bot-token en de vereiste bereiken; let bij configuraties met SecretRef op `botTokenStatus` / `appTokenStatus = configured_unavailable`.
Privéberichten worden geblokkeerd	`openclaw pairing list slack`	Keur de koppeling goed of versoepel het beleid voor privéberichten.
Kanaalbericht wordt genegeerd	Controleer `groupPolicy` en de toegestane lijst voor kanalen	Sta het kanaal toe of wijzig het beleid in `open`.

Volledige probleemoplossing: Probleemoplossing voor Slack

iMessage

iMessage-foutsignaturen

Symptoom	Snelste controle	Oplossing
`imsg` ontbreekt of werkt niet buiten macOS	`openclaw channels status --probe --channel imessage`	Voer OpenClaw uit op de Mac met Berichten of gebruik een SSH-wrapper voor `cliPath`.
Kan verzenden, maar niet ontvangen op macOS	Controleer de macOS-privacyrechten voor automatisering van Berichten	Verleen de TCC-rechten opnieuw en herstart het kanaalproces.
Afzender van privéberichten geblokkeerd	`openclaw pairing list imessage`	Keur de koppeling goed of werk de toegestane lijst bij.

Volledige probleemoplossing: Probleemoplossing voor iMessage

Signal

Signal-foutsignaturen

Symptoom	Snelste controle	Oplossing
Daemon bereikbaar, maar bot blijft stil	`openclaw channels status --probe`	Controleer de daemon-URL/het account van `signal-cli` en de ontvangstmodus.
Privébericht geblokkeerd	`openclaw pairing list signal`	Keur de afzender goed of pas het beleid voor privéberichten aan.
Groepsantwoorden worden niet geactiveerd	Controleer de toegestane lijst voor groepen en vermeldingspatronen	Voeg de afzender/groep toe of versoepel de filtering.

Volledige probleemoplossing: Probleemoplossing voor Signal

QQ Bot

QQ Bot-foutsignaturen

Symptoom	Snelste controle	Oplossing
Bot antwoordt "gone to Mars"	Controleer `appId` en `clientSecret` in de configuratie	Stel de aanmeldgegevens in of herstart de Gateway.
Geen inkomende berichten	`openclaw channels status --probe`	Controleer de aanmeldgegevens op het QQ Open Platform.
Spraak wordt niet getranscribeerd	Controleer de configuratie van de STT-provider	Configureer `channels.qqbot.stt` of `tools.media.audio`.
Proactieve berichten komen niet aan	Controleer de interactievereisten van het QQ-platform	QQ kan door de bot geïnitieerde berichten blokkeren zonder recente interactie.

Volledige probleemoplossing: Probleemoplossing voor QQ Bot

Matrix

Matrix-foutsignaturen

Symptoom	Snelste controle	Oplossing
Aangemeld, maar negeert berichten in ruimtes	`openclaw channels status --probe`	Controleer `groupPolicy`, de toelatingslijst voor ruimtes en de vereiste vermelding.
Privéberichten worden niet verwerkt	`openclaw pairing list matrix`	Keur de afzender goed of pas het beleid voor privéberichten aan.
Versleutelde ruimtes werken niet	`openclaw matrix verify status`	Verifieer het apparaat opnieuw en controleer vervolgens `openclaw matrix verify backup status`.
Back-upherstel wacht of werkt niet	`openclaw matrix verify backup status`	Voer `openclaw matrix verify backup restore` uit of probeer het opnieuw met een herstelsleutel.
Kruisondertekening/bootstrap lijkt onjuist	`openclaw matrix verify bootstrap`	Herstel in één keer de geheime opslag, kruisondertekening en back-upstatus.

Volledige installatie en configuratie: Matrix

Gerelateerd

Was this useful?