Dépannage des canaux

Utilisez cette page lorsqu’un canal se connecte, mais que son comportement est incorrect.

Séquence de commandes

Exécutez d’abord ces commandes dans l’ordre indiqué :

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

État de référence sain :

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable ou admin-capable
La sonde du canal indique que le transport est connecté et, lorsque cela est pris en charge, works ou audit ok

Après une mise à jour

Utilisez cette procédure lorsque Telegram, iMessage, les configurations datant de l’époque de BlueBubbles ou un autre canal de Plugin disparaît après une mise à jour.

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 la configuration ou le chargement du Plugin a rencontré une arborescence de dépendances corrompue au lieu d’enregistrer le canal. openclaw doctor --fix supprime les liens symboliques obsolètes des dépendances d’exécution du Plugin ainsi que les doublons d’authentification obsolètes, puis openclaw gateway restart recharge un état propre.

Signatures d’échec de WhatsApp

Symptôme	Vérification la plus rapide	Correction
Connecté, mais aucune réponse en MP	`openclaw pairing list whatsapp`	Approuvez l’expéditeur ou modifiez la politique de MP ou la liste d’autorisation.
Messages de groupe ignorés	Vérifiez `requireMention` et les motifs de mention dans la configuration	Mentionnez le bot ou assouplissez la politique de mention pour ce groupe.
La connexion par code QR expire avec une erreur 408	Vérifiez les variables d’environnement `HTTPS_PROXY` / `HTTP_PROXY` du Gateway	Définissez un proxy accessible ; utilisez `NO_PROXY` uniquement pour les contournements.
Déconnexions ou boucles de reconnexion aléatoires	`openclaw channels status --probe` et les journaux	Les reconnexions récentes sont signalées même si le canal est actuellement connecté ; surveillez les journaux, redémarrez le Gateway, puis réassociez-le si l’instabilité persiste.
Boucle `status=408 Request Time-out`	Sonde, journaux, doctor, puis état du Gateway	Corrigez d’abord la connectivité ou la synchronisation temporelle de l’hôte ; sauvegardez l’authentification et réassociez le compte si la boucle persiste.
Les réponses arrivent avec plusieurs secondes ou minutes de retard	`openclaw doctor --fix`	Doctor arrête les clients TUI locaux obsolètes dont il a été vérifié qu’ils dégradent la boucle d’événements du Gateway.

Dépannage complet : Dépannage de WhatsApp

Signatures d’échec de Telegram

Symptôme	Vérification la plus rapide	Correction
`/start`, mais aucun flux de réponse utilisable	`openclaw pairing list telegram`	Approuvez l’association ou modifiez la politique de MP.
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 rendre le groupe visible ou mentionnez le bot.
Échecs d’envoi avec des erreurs réseau	Consultez les journaux pour détecter les échecs d’appel à l’API Telegram	Corrigez le routage DNS, IPv6 ou du proxy vers `api.telegram.org`.
Le démarrage signale `getMe returned 401`	Vérifiez la source du jeton configurée	Copiez de nouveau ou régénérez le jeton BotFather et mettez à jour `botToken`, `tokenFile` ou `TELEGRAM_BOT_TOKEN` du compte par défaut.
L’interrogation se bloque ou se reconnecte lentement	Consultez `openclaw logs --follow` pour les diagnostics d’interrogation	Effectuez une mise à niveau ; si les redémarrages sont des faux positifs, ajustez `pollingStallThresholdMs`. Les blocages persistants indiquent toujours un problème de proxy, de DNS ou d’IPv6.
`setMyCommands` est refusé au démarrage	Recherchez `BOT_COMMANDS_TOO_MUCH` dans les journaux	Réduisez le nombre de commandes Telegram des Plugins, des Skills ou personnalisées, ou désactivez les menus natifs.
Après une mise à niveau, la liste d’autorisation vous bloque	`openclaw security audit` et les listes d’autorisation de la configuration	Exécutez `openclaw doctor --fix` ou remplacez `@username` par les identifiants numériques des expéditeurs.

Dépannage complet : Dépannage de Telegram

Discord

Signatures d’échec de Discord

Symptôme	Vérification la plus rapide	Correction
Bot en ligne, mais aucune réponse sur le serveur	`openclaw channels status --probe`	Autorisez le serveur ou le canal et vérifiez l’intention d’accès au contenu des messages.
Messages de groupe ignorés	Recherchez dans les journaux les rejets dus au filtrage des mentions	Mentionnez le bot ou définissez `requireMention: false` pour le serveur ou le canal.
Utilisation de la saisie ou des jetons, mais aucun message Discord	Vérifiez s’il s’agit d’un événement de salon ambiant ou d’un salon `message_tool` activé dans lequel le modèle n’a pas appelé `message(action=send)`	Consultez le journal détaillé du Gateway pour rechercher les métadonnées de charge utile finale supprimées, vérifiez `messages.groupChat.unmentionedInbound`, lisez Événements de salon ambiant ou conservez `messages.groupChat.visibleReplies: "automatic"` pour les requêtes de groupe normales.
Réponses en MP manquantes	`openclaw pairing list discord`	Approuvez l’association des MP ou ajustez la politique de MP.

Dépannage complet : Dépannage de Discord

Slack

Signatures d’échec de Slack

Symptôme	Vérification la plus rapide	Correction
Mode socket connecté, mais aucune réponse	`openclaw channels status --probe`	Vérifiez le jeton d’application, le jeton du bot et les portées requises ; surveillez `botTokenStatus` / `appTokenStatus = configured_unavailable` dans les configurations reposant sur SecretRef.
MP bloqués	`openclaw pairing list slack`	Approuvez l’association ou assouplissez la politique de MP.
Message de canal ignoré	Vérifiez `groupPolicy` et la liste d’autorisation des canaux	Autorisez le canal ou définissez la politique sur `open`.

Dépannage complet : Dépannage de Slack

iMessage

Signatures d’échec d’iMessage

Symptôme	Vérification la plus rapide	Correction
`imsg` est absent ou échoue hors de macOS	`openclaw channels status --probe --channel imessage`	Exécutez OpenClaw sur le Mac hébergeant Messages ou utilisez un adaptateur SSH pour `cliPath`.
Envoi possible, mais aucune réception sous macOS	Vérifiez les autorisations de confidentialité macOS pour l’automatisation de Messages	Accordez de nouveau les autorisations TCC et redémarrez le processus du canal.
Expéditeur de MP bloqué	`openclaw pairing list imessage`	Approuvez l’association ou mettez à jour la liste d’autorisation.

Dépannage complet : Dépannage d’iMessage

Signal

Signatures d’échec de Signal

Symptôme	Vérification la plus rapide	Correction
Démon accessible, mais bot silencieux	`openclaw channels status --probe`	Vérifiez l’URL du démon `signal-cli`, le compte et le mode de réception.
MP bloqué	`openclaw pairing list signal`	Approuvez l’expéditeur ou ajustez la politique de MP.
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 ou le groupe, ou assouplissez le filtrage.

Dépannage complet : Dépannage de Signal

Bot QQ

Signatures d’échec du bot QQ

Symptôme	Vérification la plus rapide	Correction
Le bot répond qu’il est « 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 la plateforme ouverte QQ.
La voix n’est pas 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 en l’absence d’interaction récente.

Dépannage complet : Dépannage du bot QQ

Matrix

Signatures d’échec de Matrix

Symptôme	Vérification la plus rapide	Correction
Connecté, mais les messages des salons sont ignorés	`openclaw channels status --probe`	Vérifiez `groupPolicy`, la liste d’autorisation des salons et le filtrage des mentions.
Les messages privés ne sont pas traités	`openclaw pairing list matrix`	Approuvez l’expéditeur ou ajustez la politique des messages privés.
Les salons chiffrés échouent	`openclaw matrix verify status`	Vérifiez à nouveau l’appareil, puis consultez `openclaw matrix verify backup status`.
La restauration de sauvegarde est bloquée ou échoue	`openclaw matrix verify backup status`	Exécutez `openclaw matrix verify backup restore` ou relancez la commande avec une clé de récupération.
La signature croisée ou l’amorçage semble incorrect	`openclaw matrix verify bootstrap`	Réparez en une seule opération le stockage des secrets, la signature croisée et l’état de la sauvegarde.

Configuration complète : Matrix

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Dépannage des canaux

Séquence de commandes

Après une mise à jour

WhatsApp

Signatures d’échec de WhatsApp

Telegram

Signatures d’échec de Telegram

Discord

Signatures d’échec de Discord

Slack

Signatures d’échec de Slack

iMessage

Signatures d’échec d’iMessage

Signal

Signatures d’échec de Signal

Bot QQ

Signatures d’échec du bot QQ

Matrix

Signatures d’échec de Matrix

Pages connexes

​Séquence de commandes

​Après une mise à jour

​WhatsApp

​Signatures d’échec de WhatsApp

​Telegram

​Signatures d’échec de Telegram

​Discord

​Signatures d’échec de Discord

​Slack

​Signatures d’échec de Slack

​iMessage

​Signatures d’échec d’iMessage

​Signal

​Signatures d’échec de Signal

​Bot QQ

​Signatures d’échec du bot QQ

​Matrix

​Signatures d’échec de Matrix

​Pages connexes

Séquence de commandes

Après une mise à jour

WhatsApp

Signatures d’échec de WhatsApp

Telegram

Signatures d’échec de Telegram

Discord

Signatures d’échec de Discord

Slack

Signatures d’échec de Slack

iMessage

Signatures d’échec d’iMessage

Signal

Signatures d’échec de Signal

Bot QQ

Signatures d’échec du bot QQ

Matrix

Signatures d’échec de Matrix

Pages connexes