> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Dépannage des canaux Utilisez cette page lorsqu’un canal se connecte, mais que le comportement est incorrect. ## Séquence de commandes Exécutez d’abord celles-ci dans l’ordre : ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status openclaw gateway status openclaw logs --follow openclaw doctor openclaw channels status --probe ``` Référence saine : * `Runtime: running` * `Connectivity probe: ok` * `Capability: read-only`, `write-capable`, ou `admin-capable` * La sonde de canal indique que le transport est connecté et, lorsque c’est pris en charge, `works` ou `audit ok` ## Après une mise à jour Utilisez ceci lorsque Telegram, iMessage, les configurations de l’ère BlueBubbles ou un autre canal de Plugin disparaît après une mise à jour. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status --all openclaw doctor --fix openclaw gateway restart openclaw status --all ``` Recherchez `plugin load failed: dependency tree corrupted; run openclaw doctor --fix` dans `openclaw status --all`. Cela signifie que le canal est configuré, mais que le chemin de configuration/chargement du Plugin a rencontré un arbre de dépendances corrompu au lieu d’enregistrer le canal. `openclaw doctor --fix` supprime les répertoires obsolètes de préparation des dépendances de Plugin et les ombres d’authentification obsolètes, puis `openclaw gateway restart` recharge l’état propre. ## WhatsApp ### Signatures de panne WhatsApp | Symptôme | Vérification la plus rapide | Correctif | | --------------------------------------------------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Connecté, mais aucune réponse en DM | `openclaw pairing list whatsapp` | Approuvez l’expéditeur ou changez la politique DM/liste d’autorisation. | | Messages de groupe ignorés | Vérifiez `requireMention` + les motifs de mention dans la configuration | Mentionnez le bot ou assouplissez la politique de mention pour ce groupe. | | La connexion QR expire avec 408 | Vérifiez les variables d’environnement `HTTPS_PROXY` / `HTTP_PROXY` du Gateway | Définissez un proxy joignable ; utilisez `NO_PROXY` uniquement pour les contournements. | | Boucles aléatoires de déconnexion/reconnexion | `openclaw channels status --probe` + journaux | Les reconnexions récentes sont signalées même lorsque la connexion est actuellement établie ; surveillez les journaux, redémarrez le Gateway, puis reliez le compte si les oscillations continuent. | | Boucle `status=408 Request Time-out` | Sonde, journaux, doctor, puis statut du Gateway | Corrigez d’abord la connectivité/le timing de l’hôte ; sauvegardez l’authentification et reliez à nouveau le compte si la boucle persiste. | | Les réponses arrivent avec des secondes/minutes de retard | `openclaw doctor --fix` | Doctor arrête les clients TUI locaux obsolètes vérifiés lorsqu’ils dégradent la boucle d’événements du Gateway. | Dépannage complet : [Dépannage WhatsApp](/fr/channels/whatsapp#troubleshooting) ## Telegram ### Signatures de panne Telegram | Symptôme | Vérification la plus rapide | Correctif | | -------------------------------------------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/start`, mais aucun flux de réponse utilisable | `openclaw pairing list telegram` | Approuvez l’association ou modifiez la politique DM. | | Bot en ligne, mais le groupe reste silencieux | Vérifiez l’exigence de mention et le mode de confidentialité du bot | Désactivez le mode de confidentialité pour la visibilité du groupe ou mentionnez le bot. | | Échecs d’envoi avec erreurs réseau | Inspectez les journaux pour les échecs d’appels à l’API Telegram | Corrigez le routage DNS/IPv6/proxy vers `api.telegram.org`. | | Le démarrage signale `getMe returned 401` | Vérifiez la source de jeton configurée | Recopiez ou régénérez le jeton BotFather et mettez à jour `botToken`, `tokenFile`, ou le compte par défaut `TELEGRAM_BOT_TOKEN`. | | L’interrogation se bloque ou se reconnecte lentement | `openclaw logs --follow` pour les diagnostics d’interrogation | Mettez à niveau ; si les redémarrages sont des faux positifs, ajustez `pollingStallThresholdMs`. Les blocages persistants indiquent toujours un problème de proxy/DNS/IPv6. | | `setMyCommands` rejeté au démarrage | Inspectez les journaux pour `BOT_COMMANDS_TOO_MUCH` | Réduisez les commandes Telegram de Plugin/Skills/personnalisées ou désactivez les menus natifs. | | Après mise à niveau, la liste d’autorisation vous bloque | `openclaw security audit` et listes d’autorisation de configuration | Exécutez `openclaw doctor --fix` ou remplacez `@username` par des ID d’expéditeur numériques. | Dépannage complet : [Dépannage Telegram](/fr/channels/telegram#troubleshooting) ## Discord ### Signatures de panne Discord | Symptôme | Vérification la plus rapide | Correctif | | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bot en ligne, mais aucune réponse de serveur | `openclaw channels status --probe` | Autorisez le serveur/canal et vérifiez l’intention de contenu des messages. | | Messages de groupe ignorés | Vérifiez dans les journaux les rejets par filtrage de mention | Mentionnez le bot ou définissez `requireMention: false` pour le serveur/canal. | | Utilisation de saisie/jeton, mais aucun message Discord | Vérifiez s’il s’agit d’un événement de salon ambiant ou d’un salon `message_tool` activé où le modèle a manqué `message(action=send)` | Inspectez le journal détaillé du Gateway pour les métadonnées de charge utile finale supprimées, vérifiez `messages.groupChat.unmentionedInbound`, lisez [Événements de salon ambiant](/fr/channels/ambient-room-events), ou conservez `messages.groupChat.visibleReplies: "automatic"` pour les demandes de groupe normales. | | Réponses DM manquantes | `openclaw pairing list discord` | Approuvez l’association DM ou ajustez la politique DM. | Dépannage complet : [Dépannage Discord](/fr/channels/discord#troubleshooting) ## Slack ### Signatures de panne Slack | Symptôme | Vérification la plus rapide | Correctif | | ----------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Mode socket connecté, mais aucune réponse | `openclaw channels status --probe` | Vérifiez le jeton d’application + le jeton de bot et les portées requises ; surveillez `botTokenStatus` / `appTokenStatus = configured_unavailable` sur les configurations basées sur SecretRef. | | DM bloqués | `openclaw pairing list slack` | Approuvez l’association ou assouplissez la politique DM. | | Message de canal ignoré | Vérifiez `groupPolicy` et la liste d’autorisation du canal | Autorisez le canal ou basculez la politique sur `open`. | Dépannage complet : [Dépannage Slack](/fr/channels/slack#troubleshooting) ## iMessage ### Signatures de panne iMessage | Symptôme | Vérification la plus rapide | Correctif | | ------------------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | | `imsg` absent ou échoue hors macOS | `openclaw channels status --probe --channel imessage` | Exécutez OpenClaw sur le Mac Messages ou utilisez un wrapper SSH pour `cliPath`. | | Peut envoyer, mais ne reçoit rien sur macOS | Vérifiez les autorisations de confidentialité macOS pour l’automatisation de Messages | Réaccordez les autorisations TCC et redémarrez le processus de canal. | | Expéditeur DM bloqué | `openclaw pairing list imessage` | Approuvez l’association ou mettez à jour la liste d’autorisation. | Dépannage complet : * [Dépannage iMessage](/fr/channels/imessage#troubleshooting) ## Signal ### Signatures de panne Signal | Symptôme | Vérification la plus rapide | Correctif | | -------------------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------- | | Démon joignable, mais bot silencieux | `openclaw channels status --probe` | Vérifiez l’URL/le compte du démon `signal-cli` et le mode de réception. | | DM bloqué | `openclaw pairing list signal` | Approuvez l’expéditeur ou ajustez la politique DM. | | Les réponses de groupe ne se déclenchent pas | Vérifiez la liste d’autorisation du groupe et les motifs de mention | Ajoutez l’expéditeur/le groupe ou assouplissez le filtrage. | Dépannage complet : [Dépannage Signal](/fr/channels/signal#troubleshooting) ## QQ Bot ### Signatures de panne QQ Bot | Symptôme | Vérification la plus rapide | Correctif | | ------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------- | | Le bot répond « parti sur Mars » | Vérifiez `appId` et `clientSecret` dans la configuration | Définissez les identifiants ou redémarrez le Gateway. | | Aucun message entrant | `openclaw channels status --probe` | Vérifiez les identifiants sur QQ Open Platform. | | Voix non transcrite | Vérifiez la configuration du fournisseur STT | Configurez `channels.qqbot.stt` ou `tools.media.audio`. | | Les messages proactifs n’arrivent pas | Vérifiez les exigences d’interaction de la plateforme QQ | QQ peut bloquer les messages initiés par le bot sans interaction récente. | Dépannage complet : [Dépannage de QQ Bot](/fr/channels/qqbot#troubleshooting) ## Matrix ### Signatures d’échec de Matrix | Symptôme | Vérification la plus rapide | Correctif | | ------------------------------------------------------ | -------------------------------------- | ----------------------------------------------------------------------------------------------- | | Connecté, mais ignore les messages de salon | `openclaw channels status --probe` | Vérifiez `groupPolicy`, la liste d’autorisation des salons et le filtrage par mention. | | Les DM ne sont pas traités | `openclaw pairing list matrix` | Approuvez l’expéditeur ou ajustez la politique de DM. | | Les salons chiffrés échouent | `openclaw matrix verify status` | Revérifiez l’appareil, puis vérifiez `openclaw matrix verify backup status`. | | La restauration de sauvegarde est en attente ou cassée | `openclaw matrix verify backup status` | Exécutez `openclaw matrix verify backup restore` ou relancez avec une clé de récupération. | | La signature croisée/le bootstrap semble incorrect | `openclaw matrix verify bootstrap` | Réparez le stockage secret, la signature croisée et l’état de la sauvegarde en une seule passe. | Configuration complète : [Matrix](/fr/channels/matrix) ## Connexe * [Appairage](/fr/channels/pairing) * [Routage des canaux](/fr/channels/channel-routing) * [Dépannage du Gateway](/fr/gateway/troubleshooting)