Dépannage des canaux OpenClaw

La plupart des problèmes de canal ne sont pas des problèmes de transport. Le bot est affiché connecté, le jeton est valide, et pourtant rien ne répond. La page de dépannage des canaux existe exactement pour cet écart : une échelle de commandes fixe, une base saine à laquelle comparer, et des tableaux par canal de signatures de panne avec la vérification la plus rapide pour chacune. Voici l’échelle et les signatures qui reviennent le plus.

L’échelle et la base

• Lancez dans l’ordre openclaw status, openclaw gateway status, openclaw logs --follow, openclaw doctor, puis openclaw channels status --probe ; la base saine affiche Runtime running, Connectivity probe ok, une Capability read-only, write-capable ou admin-capable, et une sonde de canal montrant le transport connecté et, quand c’est pris en charge, works ou audit ok.
• Après une mise à jour, quand Telegram, iMessage, une configuration de l’ère BlueBubbles ou un autre canal de plugin disparaît, lancez status --all, doctor --fix, gateway restart puis status --all de nouveau ; la ligne à chercher est un échec de chargement de plugin avec un arbre de dépendances corrompu, ce qui signifie que le canal est configuré mais que l’installation du plugin est tombée sur des liens symboliques corrompus au lieu de l’enregistrer.
• Signatures WhatsApp : connecté sans réponse en DM signifie pairing list whatsapp puis approuver l’expéditeur ou changer la politique de DM ; messages de groupe ignorés signifie l’exigence de mention ; une connexion QR qui expire en 408 signifie l’environnement proxy de la passerelle ; des boucles de reconnexion signifient la sonde plus les journaux, puis redémarrer et relier si ça continue à battre ; des réponses en retard de plusieurs minutes signifient doctor --fix, qui arrête les clients TUI locaux périmés vérifiés qui dégradent la boucle d’événements.
• Signatures Telegram : un start sans flux de réponse utilisable signifie l’appairage ; un groupe silencieux signifie l’exigence de mention ou le mode privé du bot ; des échecs d’envoi réseau signifient le DNS, l’IPv6 ou le routage proxy vers l’API Telegram ; un getMe 401 au démarrage signifie la source du jeton ; des blocages de polling signifient mettre à niveau puis le proxy ou le DNS ; un setMyCommands rejeté signifie trop de commandes ; une liste blanche qui vous bloque après une mise à niveau signifie doctor --fix ou des identifiants d’expéditeur numériques à la place des noms d’utilisateur.

Une carte de canaux est une liste blanche : les canaux non listés sont refusés.

Discord et Slack

Discord a le tableau le plus long. Un bot en ligne sans réponse dans le serveur, c’est une sonde puis autoriser le serveur ou le canal et vérifier l’intent de contenu des messages. De la saisie et de la consommation de jetons sans message Discord signifie que le modèle a traité le salon comme un événement ambiant ou un salon opté pour l’outil message et a manqué l’action d’envoi ; le journal détaillé de la passerelle montre la charge finale supprimée. Un bot devenu silencieux dans des canaux qui fonctionnaient a en général gagné une carte de canaux sur son entrée de serveur, et le correctif est une entrée joker. Un agent qui ne voit pas l’historique du salon venant d’autres bots a besoin d’une exigence de mention relâchée et du réglage allowBots du compte, et un agent qui observe un salon ambiant sans jamais poster manque l’outil message que les profils minimal et coding omettent. Slack est plus court : mode socket connecté sans réponse signifie le jeton d’application, le jeton de bot et les scopes, avec un statut de jeton configuré mais indisponible sur les installations adossées à SecretRef ; des DM bloqués signifient l’appairage ; un message de canal ignoré signifie la politique de groupe et la liste blanche.

Les autres canaux et le disjoncteur

• iMessage : un imsg manquant ou en échec hors macOS signifie faire tourner OpenClaw sur le Mac de Messages ou un wrapper SSH pour le chemin CLI ; envoyer sans recevoir signifie les permissions de confidentialité macOS ; un expéditeur de DM bloqué signifie l’appairage. Signal : un démon joignable avec un bot silencieux signifie l’URL de signal-cli, le compte et le mode de réception.
• QQ Bot : une réponse qui dit que le bot est parti sur Mars signifie l’identifiant d’application et le secret client ; aucun message entrant signifie les identifiants de la plateforme ; une voix non transcrite signifie la configuration du fournisseur STT ; des messages proactifs absents signifient que la plateforme bloque les messages à l’initiative du bot sans interaction récente. Matrix : des messages de salon ignorés signifient la politique de groupe, la liste blanche des salons et le filtrage par mention ; des salons chiffrés en échec signifient verify status puis backup status ; une restauration cassée signifie backup restore avec une clé de récupération ; une signature croisée étrange signifie verify bootstrap.
• Si la passerelle est saine mais qu’un canal reste arrêté après plusieurs démarrages non propres, le disjoncteur de boucle de plantage peut supprimer le démarrage automatique du canal : un appel de passerelle à channels.start avec l’identifiant du canal le contourne immédiatement, ou le même processus revérifie le disjoncteur une fois la fenêtre de démarrages non propres écoulée.

Dépannage Telegram d’OpenClaw et Dépannage Discord d’OpenClaw sont les articles de dépannage complets par canal vers lesquels cette page renvoie en premier.

Pourquoi l’ordre compte

L’échelle va de la vue la plus large à la plus étroite : status dit si le runtime tourne seulement, gateway status si le plan de contrôle répond, le suivi des journaux montre ce qui se passe maintenant, doctor trouve et répare les mauvaises configurations connues, et la sonde est la seule commande qui demande à chaque canal si son transport fonctionne vraiment. Sauter à la sonde quand le runtime ne tourne pas produit une réponse trompeuse, et lire les journaux avant doctor revient à lire des symptômes que doctor aurait nommés. Dépannage Slack d’OpenClaw contient le tableau Slack en profondeur et L’appairage OpenClaw explique la liste d’appairage vers laquelle la moitié des signatures de DM pointent.

Sur Diali

Sur Diali les canaux sont connectés depuis le tableau de bord, la configuration d’exécution est générée à partir de lui et remplacée à chaque version, et la même sonde tourne sur le runtime hébergé. OpenClaw hébergé sur Diali est l’assistant et WhatsApp sur Diali la page du canal WhatsApp, le canal au tableau de signatures le plus long ci-dessus.

• Status, gateway status, logs, doctor, sonde : dans cet ordre.
• Un canal disparu après une mise à jour : doctor --fix puis redémarrage.
• La moitié des signatures de DM se résolvent à la liste d’appairage.