Configuration

Dépannage des canaux

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

Échelle de commandes

Exécutez-les d'abord dans l'ordre :

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

État sain de base :

  • Runtime: running
  • RPC probe: ok
  • La sonde du canal affiche connecté/prêt

WhatsApp

Signatures d'échec WhatsApp

SymptômeVérification la plus rapideCorrection
Connecté mais pas de réponses en MPopenclaw pairing list whatsappApprouvez l'expéditeur ou changez la politique de MP/liste autorisée.
Messages de groupe ignorésVérifiez requireMention + modèles de mention dans la configMentionnez le bot ou assouplissez la politique de mention pour ce groupe.
Boucles de déconnexion/reconnexion aléatoiresopenclaw channels status --probe + logsReconnectez-vous et vérifiez que le répertoire des identifiants est sain.

Dépannage complet : /channels/whatsapp#troubleshooting-quick

Telegram

Signatures d'échec Telegram

SymptômeVérification la plus rapideCorrection
/start mais pas de flux de réponse utilisableopenclaw pairing list telegramApprouvez l'appairage ou changez la politique de MP.
Bot en ligne mais le groupe reste silencieuxVérifiez l'exigence de mention et le mode confidentialité du botDésactivez le mode confidentialité pour la visibilité du groupe ou mentionnez le bot.
Échecs d'envoi avec erreurs réseauInspectez les logs pour les échecs d'appel API TelegramCorrigez le routage DNS/IPv6/proxy vers api.telegram.org.
Mise à niveau et liste autorisée vous bloqueopenclaw security audit et listes autorisées de configExécutez openclaw doctor --fix ou remplacez @username par des ID d'expéditeur numériques.

Dépannage complet : /channels/telegram#troubleshooting

Discord

Signatures d'échec Discord

SymptômeVérification la plus rapideCorrection
Bot en ligne mais pas de réponses 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 les logs pour les rejets de mentionMentionnez le bot ou définissez requireMention: false pour la guilde/le canal.
Réponses en MP manquantesopenclaw pairing list discordApprouvez l'appairage MP ou ajustez la politique de MP.

Dépannage complet : /channels/discord#troubleshooting

Slack

Signatures d'échec Slack

SymptômeVérification la plus rapideCorrection
Mode socket connecté mais pas de réponsesopenclaw channels status --probeVérifiez le jeton d'application + le jeton du bot et les portées requises.
MPs bloquésopenclaw pairing list slackApprouvez l'appairage ou assouplissez la politique de MP.
Message de canal ignoréVérifiez groupPolicy et la liste autorisée du canalAutorisez le canal ou passez à la politique open.

Dépannage complet : /channels/slack#troubleshooting

iMessage et BlueBubbles

Signatures d'échec iMessage et BlueBubbles

SymptômeVérification la plus rapideCorrection
Aucun événement entrantVérifiez l'accessibilité du webhook/du serveur et les permissions de l'applicationCorrigez l'URL du webhook ou l'état du serveur BlueBubbles.
Peut envoyer mais pas recevoir sur macOSVérifiez les permissions de confidentialité macOS pour l'automatisation de MessagesRéattribuez les permissions TCC et redémarrez le processus du canal.
Expéditeur en MP bloquéopenclaw pairing list imessage ou openclaw pairing list bluebubblesApprouvez l'appairage ou mettez à jour la liste autorisée.

Dépannage complet :

Signal

Signatures d'échec Signal

SymptômeVérification la plus rapideCorrection
Démon accessible mais bot silencieuxopenclaw channels status --probeVérifiez l'URL/le compte du démon signal-cli et le mode de réception.
MP bloquéopenclaw pairing list signalApprouvez l'expéditeur ou ajustez la politique de MP.
Les réponses de groupe ne se déclenchent pasVérifiez la liste autorisée du groupe et les modèles de mentionAjoutez l'expéditeur/le groupe ou assouplissez la restriction.

Dépannage complet : /channels/signal#troubleshooting

Matrix

Signatures d'échec Matrix

SymptômeVérification la plus rapideCorrection
Connecté mais ignore les messages du salonopenclaw channels status --probeVérifiez groupPolicy et la liste autorisée du salon.
Les MPs ne sont pas traitésopenclaw pairing list matrixApprouvez l'expéditeur ou ajustez la politique de MP.
Les salons chiffrés échouentVérifiez le module de chiffrement et les paramètres de chiffrementActivez le support du chiffrement et rejoignez/resynchronisez le salon.

Dépannage complet : /channels/matrix#troubleshooting

Analyse de l'emplacement des canaux