Depannage des canaux

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

Echelle de commandes

Executez ces commandes dans l’ordre :

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

Etat de base sain :

  • Runtime: running
  • RPC probe: ok
  • La sonde du canal affiche connecte/pret

WhatsApp

Signatures d’erreur WhatsApp

SymptomeVerification rapideCorrectif
Connecte mais pas de reponses en DMopenclaw pairing list whatsappApprouvez l’expediteur ou changez la politique/liste DM.
Messages de groupe ignoresVerifiez requireMention + patterns de mention dans configMentionnez le bot ou assouplissez la politique pour ce groupe.
Deconnexions/boucles de reconnexionopenclaw channels status --probe + logsReconnectez et verifiez que le repertoire des identifiants est sain.

Depannage complet : /channels/whatsapp#troubleshooting-quick

Telegram

Signatures d’erreur Telegram

SymptomeVerification rapideCorrectif
/start mais pas de flux de reponse utileopenclaw pairing list telegramApprouvez l’appairage ou changez la politique DM.
Bot en ligne mais groupe silencieuxVerifiez l’exigence de mention et le mode confidentialiteDesactivez le mode confidentialite pour la visibilite du groupe ou mentionnez le bot.
Echecs d’envoi avec erreurs reseauInspectez les logs pour les echecs d’appels API TelegramCorrigez le routage DNS/IPv6/proxy vers api.telegram.org.
setMyCommands rejete au demarrageInspectez les logs pour BOT_COMMANDS_TOO_MUCHReduisez les commandes plugin/skill/personnalisees Telegram ou desactivez les menus natifs.
Mise a jour et la liste d’autorisation vous bloqueopenclaw security audit et listes de configLancez openclaw doctor --fix ou remplacez @username par des IDs numeriques.

Depannage complet : /channels/telegram#troubleshooting

Discord

Signatures d’erreur Discord

SymptomeVerification rapideCorrectif
Bot en ligne mais pas de reponseopenclaw channels status --probeAutorisez le serveur/salon et verifiez l’intent de contenu de message.
Messages de groupe ignoresVerifiez les logs pour les rejets de mentionMentionnez le bot ou definissez requireMention: false pour le serveur/salon.
Reponses DM manquantesopenclaw pairing list discordApprouvez l’appairage DM ou ajustez la politique DM.

Depannage complet : /channels/discord#troubleshooting

Slack

Signatures d’erreur Slack

SymptomeVerification rapideCorrectif
Mode socket connecte mais pas de reponsesopenclaw channels status --probeVerifiez le jeton app + bot et les scopes requis.
DMs bloquesopenclaw pairing list slackApprouvez l’appairage ou assouplissez la politique DM.
Message de salon ignoreVerifiez groupPolicy et la liste d’autorisation de salonAutorisez le salon ou passez la politique a open.

Depannage complet : /channels/slack#troubleshooting

iMessage et BlueBubbles

Signatures d’erreur iMessage et BlueBubbles

SymptomeVerification rapideCorrectif
Pas d’evenements entrantsVerifiez l’accessibilite du webhook/serveur et les permissions de l’appCorrigez l’URL du webhook ou l’etat du serveur BlueBubbles.
Peut envoyer mais ne recoit pas sur macOSVerifiez les permissions de confidentialite macOS pour l’automatisation MessagesReaccordez les permissions TCC et redemarrez le processus du canal.
Expediteur DM bloqueopenclaw pairing list imessage ou openclaw pairing list bluebubblesApprouvez l’appairage ou mettez a jour la liste d’autorisation.

Depannage complet :

Signal

Signatures d’erreur Signal

SymptomeVerification rapideCorrectif
Daemon accessible mais bot silencieuxopenclaw channels status --probeVerifiez l’URL/compte du daemon signal-cli et le mode de reception.
DM bloqueopenclaw pairing list signalApprouvez l’expediteur ou ajustez la politique DM.
Les reponses de groupe ne se declenchent pasVerifiez la liste d’autorisation du groupe et les patterns de mentionAjoutez l’expediteur/groupe ou assouplissez le filtrage.

Depannage complet : /channels/signal#troubleshooting

Matrix

Signatures d’erreur Matrix

SymptomeVerification rapideCorrectif
Connecte mais ignore les messages de salonopenclaw channels status --probeVerifiez groupPolicy et la liste d’autorisation des salons.
Les DMs ne sont pas traitesopenclaw pairing list matrixApprouvez l’expediteur ou ajustez la politique DM.
Les salons chiffres echouentVerifiez le module crypto et les parametres de chiffrementActivez le support du chiffrement et resynchronisez le salon.

Depannage complet : /channels/matrix#troubleshooting