Passer au contenu principal

​
Dépannage des canaux

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

​
Échelle de commandes

Exécutez d’abord celles-ci dans l’ordre : 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Base de référence saine :
  • Runtime: running
  • RPC probe: ok
  • La sonde du canal indique que le transport est connecté et, lorsque pris en charge, works ou audit ok

​
WhatsApp

​
Signatures de panne WhatsApp

SymptômeVérification la plus rapideCorrectif
Connecté mais aucune réponse DMopenclaw pairing list whatsappApprouvez l’expéditeur ou changez la politique DM/la liste d’autorisation.
Messages de groupe ignorésVérifiez requireMention et les motifs de mention dans la configurationMentionnez le bot ou assouplissez la politique de mention pour ce groupe.
Boucles aléatoires de déconnexion/reconnexionopenclaw channels status --probe + journauxReconnectez-vous et vérifiez que le répertoire d’identifiants est sain.
Dépannage complet : /channels/whatsapp#troubleshooting

​
Telegram

​
Signatures de panne Telegram

SymptômeVérification la plus rapideCorrectif
/start mais aucun flux de réponse exploitableopenclaw pairing list telegramApprouvez l’appairage ou modifiez la politique DM.
Bot en ligne mais groupe silencieuxVérifiez l’obligation de mention et le mode confidentialité du botDésactivez le mode confidentialité pour la visibilité en groupe ou mentionnez le bot.
Échecs d’envoi avec erreurs réseauInspectez les journaux pour les échecs d’appel à l’API TelegramCorrigez le routage DNS/IPv6/proxy vers api.telegram.org.
setMyCommands rejeté au démarrageInspectez les journaux pour BOT_COMMANDS_TOO_MUCHRéduisez les commandes Telegram de plugin/Skills/personnalisées ou désactivez les menus natifs.
Après mise à niveau, la liste d’autorisation vous bloqueopenclaw security audit et les listes d’autorisation de la configurationExécutez openclaw doctor --fix ou remplacez @username par des identifiants numériques d’expéditeur.
Dépannage complet : /channels/telegram#troubleshooting

​
Discord

​
Signatures de panne Discord

SymptômeVérification la plus rapideCorrectif
Bot en ligne mais aucune réponse dans la guildeopenclaw channels status --probeAutorisez la guilde/le canal et vérifiez l’intention de contenu des messages.
Messages de groupe ignorésVérifiez dans les journaux les rejets dus au filtrage par mentionMentionnez le bot ou définissez requireMention: false pour la guilde/le canal.
Réponses DM manquantesopenclaw pairing list discordApprouvez l’appairage DM ou ajustez la politique DM.
Dépannage complet : /channels/discord#troubleshooting

​
Slack

​
Signatures de panne Slack

SymptômeVérification la plus rapideCorrectif
Mode socket connecté mais aucune réponseopenclaw channels status --probeVérifiez le jeton d’application + le jeton de bot et les scopes requis ; surveillez botTokenStatus / appTokenStatus = configured_unavailable dans les configurations basées sur SecretRef.
DMs bloquésopenclaw pairing list slackApprouvez l’appairage ou assouplissez la politique DM.
Message de canal ignoréVérifiez groupPolicy et la liste d’autorisation des canauxAutorisez le canal ou changez la politique en open.
Dépannage complet : /channels/slack#troubleshooting

​
iMessage et BlueBubbles

​
Signatures de panne iMessage et BlueBubbles

SymptômeVérification la plus rapideCorrectif
Aucun événement entrantVérifiez l’accessibilité du webhook/serveur et les autorisations de l’applicationCorrigez l’URL du webhook ou l’état du serveur BlueBubbles.
Peut envoyer mais ne reçoit pas sur macOSVérifiez les autorisations de confidentialité macOS pour l’automatisation de MessagesRéaccordez les autorisations TCC et redémarrez le processus du canal.
Expéditeur DM bloquéopenclaw pairing list imessage ou openclaw pairing list bluebubblesApprouvez l’appairage ou mettez à jour la liste d’autorisation.
Dépannage complet :

​
Signal

​
Signatures de panne Signal

SymptômeVérification la plus rapideCorrectif
Daemon joignable mais bot silencieuxopenclaw channels status --probeVérifiez l’URL/le compte du daemon signal-cli et le mode de réception.
DM bloquéopenclaw pairing list signalApprouvez l’expéditeur ou ajustez la politique DM.
Les réponses de groupe ne se déclenchent pasVérifiez la liste d’autorisation des groupes et les motifs de mentionAjoutez l’expéditeur/le groupe ou assouplissez le filtrage.
Dépannage complet : /channels/signal#troubleshooting

​
QQ Bot

​
Signatures de panne QQ Bot

SymptômeVérification la plus rapideCorrectif
Le bot répond “gone to Mars”Vérifiez appId et clientSecret dans la configurationDéfinissez les identifiants ou redémarrez la gateway.
Aucun message entrantopenclaw channels status --probeVérifiez les identifiants sur la QQ Open Platform.
La voix n’est pas transcriteVérifiez la configuration du fournisseur STTConfigurez channels.qqbot.stt ou tools.media.audio.
Les messages proactifs n’arrivent pasVérifiez les exigences d’interaction de la plateforme QQQQ peut bloquer les messages initiés par le bot sans interaction récente.
Dépannage complet : /channels/qqbot#troubleshooting

​
Matrix

​
Signatures de panne Matrix

SymptômeVérification la plus rapideCorrectif
Connecté mais ignore les messages du salonopenclaw channels status --probeVérifiez groupPolicy, la liste d’autorisation des salons et le filtrage par mention.
Les DMs ne sont pas traitésopenclaw pairing list matrixApprouvez l’expéditeur ou ajustez la politique DM.
Les salons chiffrés échouentopenclaw matrix verify statusRevérifiez l’appareil, puis vérifiez openclaw matrix verify backup status.
La restauration de sauvegarde est en attente/casséeopenclaw matrix verify backup statusExécutez openclaw matrix verify backup restore ou relancez avec une clé de récupération.
La signature croisée/bootstrap semble incorrecteopenclaw matrix verify bootstrapRéparez le stockage des secrets, la signature croisée et l’état de sauvegarde en un seul passage.
Configuration et installation complètes : Matrix