Passer au contenu principal

Depannage des canaux

Utilisez cette page quand un canal se connecte mais que le comportement est erroné.

Échelle de commandes

Exécutez d’abord dans l’ordre :
openclaw doctor
openclaw channels status --probe
Base saine :
  • Runtime: en cours
  • sonde RPC: ok
  • La sonde de canal montre connecté/prêt

WhatsApp

Signatures d’échec WhatsApp

SymptômeContrôle le plus rapideCorrectif
Connecté mais aucune réponse DMliste d'appairage openclaw whatsappApprouver l’expéditeur ou le changement de politique / liste d’autorisations de DM.
Messages de groupe ignorésVérifiez requireMention + modèles de mention dans la configurationMentionnez le bot ou relâchez la politique de mention pour ce groupe.
Boucles de déconnexion/reconnexion aléatoiresLes journaux affichent setMyCommands failed → verifiez la connectivite HTTPS sortante et la joignabilite DNS vers api.telegram.org (courant sur des VPS verrouilles ou des proxys).La reconnexion et la vérification des identifiants est saine.
WhatsApp : /channels/whatsapp#troubleshooting-quick

Telegram

Signatures d’échec de Telegram

SymptômeContrôle le plus rapideCorrectif
/start mais aucun flux de réponse utilisableopenclaw pairing list telegramApprouver l’appairage ou la modification de la politique de DM.
Bot en ligne mais le groupe reste silencieuxVérifier l’exigence de mention et le mode de confidentialité du botDésactiver le mode confidentialité pour la visibilité des groupes ou le bot de mention
Échecs d’envoi avec erreurs de réseauInspecter les logs pour les échecs d’appel de l’API TelegramSi api.telegram.org se resout d’abord en IPv6 et que l’hote ne dispose pas de sortie IPv6, forcez IPv4 ou activez IPv6. Voir /channels/telegram#troubleshooting.
Mise à niveau effectuée et la liste d’autorisation vous bloqueopenclaw security audit et les listes d’autorisation de configurationExécutez openclaw doctor --fix ou remplacez @username par des IDs d’expéditeur numériques.
Telegram : /channels/telegram#troubleshooting

Discord

Signatures d’échec de Discord

SymptômeContrôle le plus rapideCorrectif
Bot en ligne mais aucune réponse de guildeCorrectifs rapides TelegramAutoriser la guild/canal et vérifier l’intention du contenu du message.
Messages de groupe ignorésJournal de contrôle pour les gouttes de mentionMentionnez le bot ou définissez la guild/channel requireMention: false.
Réponses DM manquantesdiscordance de la liste d'appairage openclawApprouver l’appairage du DM ou ajuster la politique du DM.
Discord : /channels/discord#troubleshooting

Slack

Signatures d’échec de Slack

SymptômeContrôle le plus rapideCorrectif
Mode Socket connecté mais sans réponsegpt-5.2-chat-latestVérifiez le jeton de l’application + le jeton de bot et les portées requises.
DMs bloquésopenclaw pairing list slackApprouver l’appairage ou le relâchement de la politique DM.
Message du salon ignoréVérifiez groupPolicy et la liste des autorisations de salonAutoriser le canal ou la politique de commutation à open.
Enquete sur une mauvaise configuration du canal (intents, permissions, mode de confidentialite)

iMessage et BlueBubbles

Signatures d’échec iMessage et BlueBubbles

SymptômeContrôle le plus rapideCorrectif
Aucun événement entrantVérifier la disponibilité du webhook/serveur et les autorisations des applicationsCorriger l’URL du webhook ou l’état du serveur BlueBubbles.
Peut envoyer mais pas de réception sur macOSVérifiez les autorisations de confidentialité macOS pour l’automatisation des messagesRéaccorder les autorisations TCC et redémarrer le processus de canal.
Expéditeur de MP bloquéopenclaw pairing list imessage ou openclaw pairing list bluebubblesApprouver l’appairage ou la mise à jour de la liste d’autorisations.
Dépannage complet :

Signal

Signaux d’échec du signal

SymptômeContrôle le plus rapideCorrectif
Démon joignable mais bot silencieuxCanauxVérifiez l’URL / le compte démon signal-cli et le mode réception.
DM bloquésopenclaw pairing list signalApprouver l’expéditeur ou ajuster la politique de DM.
Les réponses de groupe ne sont pas déclenchéesVérifier les listes d’autorisations du groupe et les modèles de mentionAjouter l’expéditeur/groupe ou la porte en douceur.
channels/troubleshooting.md

Matrix

Signatures d’échec de la matrice

SymptômeContrôle le plus rapideCorrectif
Connecté mais ignore les messages de la sallechannels status --probe affiche des avertissements lorsqu’il peut detecter des mauvaises configurations courantes de canal, et inclut de petits controles en direct (identifiants, certaines permissions/appartenances).Vérifiez groupPolicy et la liste d’autorisations de salle.
Les DMs ne traitent pasopenclaw pairing list matrixApprouver l’expéditeur ou ajuster la politique de DM.
Échec du chiffrement des sallesVérifier les paramètres de cryptage et de cryptageActiver la prise en charge du chiffrement et la salle de rejointure/synchronisation.
Dépannage complet : /channels/matrix#troubleshooting