Naar hoofdinhoud gaan
Gebruik deze pagina wanneer een kanaal verbinding maakt, maar het gedrag onjuist is.

Commandoladder

Voer deze eerst op volgorde uit:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Gezonde basislijn:
  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable, of admin-capable
  • Kanaalprobe toont dat het transport verbonden is en, waar ondersteund, works of audit ok

WhatsApp

WhatsApp-foutsignaturen

SymptoomSnelste controleOplossing
Verbonden maar geen DM-antwoordenopenclaw pairing list whatsappKeur de afzender goed of wijzig het DM-beleid/de toestemmingslijst.
Groepsberichten genegeerdControleer requireMention + vermeldingspatronen in de configuratieVermeld de bot of versoepel het vermeldingsbeleid voor die groep.
QR-login verloopt met 408Controleer Gateway-HTTPS_PROXY / HTTP_PROXY-envStel een bereikbare proxy in; gebruik NO_PROXY alleen voor omleidingen.
Willekeurige verbreek-/herloginlussenopenclaw channels status --probe + logsRecente herverbindingen worden gemarkeerd, zelfs wanneer er nu verbinding is; bekijk logs, herstart de Gateway en koppel opnieuw als het flappen doorgaat.
Antwoorden komen seconden/minuten te laatopenclaw doctor --fixDoctor stopt geverifieerde verouderde lokale TUI-clients wanneer ze de Gateway-eventloop verslechteren.
Volledige probleemoplossing: WhatsApp-probleemoplossing

Telegram

Telegram-foutsignaturen

SymptoomSnelste controleOplossing
/start maar geen bruikbare antwoordstroomopenclaw pairing list telegramKeur de koppeling goed of wijzig het DM-beleid.
Bot online maar groep blijft stilControleer de vermeldingsvereiste en de privacymodus van de botSchakel privacymodus uit voor groepszichtbaarheid of vermeld de bot.
Verzendfouten met netwerkfoutenInspecteer logs op fouten bij Telegram-API-aanroepenHerstel DNS-/IPv6-/proxyrouting naar api.telegram.org.
Startup meldt getMe returned 401Controleer de geconfigureerde tokenbronKopieer opnieuw of genereer opnieuw de BotFather-token en werk botToken, tokenFile of de standaardaccount-TELEGRAM_BOT_TOKEN bij.
Polling loopt vast of herverbindt langzaamopenclaw logs --follow voor pollingdiagnostiekUpgrade; als herstarts fout-positieven zijn, stem pollingStallThresholdMs af. Aanhoudende vastlopers wijzen nog steeds op proxy/DNS/IPv6.
setMyCommands geweigerd bij startupInspecteer logs op BOT_COMMANDS_TOO_MUCHVerminder het aantal Plugin-/skill-/aangepaste Telegram-opdrachten of schakel native menu’s uit.
Geüpgraded en toestemmingslijst blokkeert jouopenclaw security audit en configuratietoestemmingslijstenVoer openclaw doctor --fix uit of vervang @username door numerieke afzender-ID’s.
Volledige probleemoplossing: Telegram-probleemoplossing

Discord

Discord-foutsignaturen

SymptoomSnelste controleOplossing
Bot online maar geen guild-antwoordenopenclaw channels status --probeSta guild/kanaal toe en controleer de intent voor berichtinhoud.
Groepsberichten genegeerdControleer logs op weggevallen berichten door vermeldingsafschermingVermeld de bot of stel guild/kanaal requireMention: false in.
Typing-/tokengebruik maar geen Discord-berichtSessielog toont assistenttekst met didSendViaMessagingTool: falseHet model antwoordde privé in plaats van de berichttool aan te roepen. Gebruik een model dat betrouwbaar tool-calls doet, of stel messages.groupChat.visibleReplies: "automatic" in om automatisch te posten.
DM-antwoorden ontbrekenopenclaw pairing list discordKeur DM-koppeling goed of pas het DM-beleid aan.
Volledige probleemoplossing: Discord-probleemoplossing

Slack

Slack-foutsignaturen

SymptoomSnelste controleOplossing
Socketmodus verbonden maar geen antwoordenopenclaw channels status --probeControleer app-token + bot-token en vereiste scopes; let op botTokenStatus / appTokenStatus = configured_unavailable bij SecretRef-ondersteunde setups.
DM’s geblokkeerdopenclaw pairing list slackKeur koppeling goed of versoepel het DM-beleid.
Kanaalbericht genegeerdControleer groupPolicy en kanaaltoestemmingslijstSta het kanaal toe of wijzig het beleid naar open.
Volledige probleemoplossing: Slack-probleemoplossing

iMessage

iMessage-foutsignaturen

SymptoomSnelste controleOplossing
imsg ontbreekt of faalt op niet-macOSopenclaw channels status --probe --channel imessageVoer OpenClaw uit op de Messages-Mac of gebruik een SSH-wrapper voor cliPath.
Kan verzenden maar niet ontvangen op macOSControleer macOS-privacyrechten voor Messages-automatiseringKen TCC-rechten opnieuw toe en herstart het kanaalproces.
DM-afzender geblokkeerdopenclaw pairing list imessageKeur koppeling goed of werk de toestemmingslijst bij.
Volledige probleemoplossing:

Signal

Signal-foutsignaturen

SymptoomSnelste controleOplossing
Daemon bereikbaar maar bot stilopenclaw channels status --probeControleer signal-cli-daemon-URL/account en ontvangstmodus.
DM geblokkeerdopenclaw pairing list signalKeur de afzender goed of pas het DM-beleid aan.
Groepsantwoorden worden niet geactiveerdControleer groepstoestemmingslijst en vermeldingspatronenVoeg afzender/groep toe of versoepel afscherming.
Volledige probleemoplossing: Signal-probleemoplossing

QQ Bot

QQ Bot-foutsignaturen

SymptoomSnelste controleOplossing
Bot antwoordt “naar Mars gegaan”Controleer appId en clientSecret in configuratieStel inloggegevens in of herstart de Gateway.
Geen inkomende berichtenopenclaw channels status --probeControleer inloggegevens op het QQ Open Platform.
Spraak niet getranscribeerdControleer STT-providerconfiguratieConfigureer channels.qqbot.stt of tools.media.audio.
Proactieve berichten komen niet aanControleer interactievereisten van het QQ-platformQQ kan door bots geïnitieerde berichten blokkeren zonder recente interactie.
Volledige probleemoplossing: QQ Bot-probleemoplossing

Matrix

Matrix-foutsignaturen

SymptoomSnelste controleOplossing
Ingelogd maar negeert kamerberichtenopenclaw channels status --probeControleer groupPolicy, kamertoestemmingslijst en vermeldingsafscherming.
DM’s worden niet verwerktopenclaw pairing list matrixKeur de afzender goed of pas het DM-beleid aan.
Versleutelde kamers falenopenclaw matrix verify statusVerifieer het apparaat opnieuw en controleer daarna openclaw matrix verify backup status.
Back-upherstel is in behandeling/defectopenclaw matrix verify backup statusVoer openclaw matrix verify backup restore uit of voer opnieuw uit met een herstelsleutel.
Cross-signing/bootstrap ziet er verkeerd uitopenclaw matrix verify bootstrapHerstel geheime opslag, cross-signing en back-upstatus in één keer.
Volledige setup en configuratie: Matrix

Gerelateerd