Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Utilisez cette page lorsqu’un canal se connecte, mais que le comportement est incorrect.
Échelle de commandes
Exécutez d’abord ces commandes dans l’ordre :
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Runtime: runningConnectivity probe: okCapability: read-only, write-capable ou admin-capable- La sonde du canal indique que le transport est connecté et, lorsque c’est pris en charge,
works ou audit ok
WhatsApp
Signatures d’échec WhatsApp
| Symptôme | Vérification la plus rapide | Correctif |
|---|
| Connecté, mais aucune réponse en DM | openclaw pairing list whatsapp | Approuvez l’expéditeur ou changez la stratégie/liste d’autorisation des DM. |
| Messages de groupe ignorés | Vérifiez requireMention + les motifs de mention dans la configuration | Mentionnez le bot ou assouplissez la stratégie de mention pour ce groupe. |
| La connexion QR expire avec 408 | Vérifiez les variables d’environnement HTTPS_PROXY / HTTP_PROXY du Gateway | Définissez un proxy joignable ; utilisez NO_PROXY uniquement pour les contournements. |
| Boucles aléatoires de déconnexion/reconnexion | openclaw channels status --probe + journaux | Les reconnexions récentes sont signalées même lorsque la connexion est actuellement active ; surveillez les journaux, redémarrez le Gateway, puis reliez à nouveau si l’instabilité continue. |
| Les réponses arrivent avec plusieurs secondes/minutes de retard | openclaw doctor --fix | Doctor arrête les clients TUI locaux obsolètes vérifiés lorsqu’ils dégradent la boucle d’événements du Gateway. |
Telegram
Signatures d’échec Telegram
| Symptôme | Vérification la plus rapide | Correctif |
|---|
/start, mais aucun flux de réponse utilisable | openclaw pairing list telegram | Approuvez l’association ou changez la stratégie de DM. |
| Bot en ligne, mais le groupe reste silencieux | Vérifiez l’exigence de mention et le mode confidentialité du bot | Désactivez le mode confidentialité pour la visibilité du groupe ou mentionnez le bot. |
| Échecs d’envoi avec erreurs réseau | Inspectez les journaux pour les échecs d’appels à l’API Telegram | Corrigez le routage DNS/IPv6/proxy vers api.telegram.org. |
Le démarrage signale getMe returned 401 | Vérifiez la source du jeton configurée | Recopiez ou régénérez le jeton BotFather et mettez à jour botToken, tokenFile ou TELEGRAM_BOT_TOKEN du compte par défaut. |
| L’interrogation se bloque ou se reconnecte lentement | openclaw logs --follow pour les diagnostics d’interrogation | Mettez à niveau ; si les redémarrages sont des faux positifs, ajustez pollingStallThresholdMs. Les blocages persistants indiquent toujours un problème de proxy/DNS/IPv6. |
setMyCommands rejeté au démarrage | Inspectez les journaux pour BOT_COMMANDS_TOO_MUCH | Réduisez les commandes Telegram de Plugin/Skills/personnalisées ou désactivez les menus natifs. |
| Après mise à niveau, la liste d’autorisation vous bloque | openclaw security audit et listes d’autorisation de configuration | Exécutez openclaw doctor --fix ou remplacez @username par des identifiants numériques d’expéditeur. |
Discord
Signatures d’échec Discord
| Symptôme | Vérification la plus rapide | Correctif |
|---|
| Bot en ligne, mais aucune réponse dans la guilde | openclaw channels status --probe | Autorisez la guilde/le canal et vérifiez l’intention de contenu des messages. |
| Messages de groupe ignorés | Vérifiez dans les journaux les abandons dus au filtrage par mention | Mentionnez le bot ou définissez requireMention: false pour la guilde/le canal. |
| Saisie/utilisation de jetons, mais aucun message Discord | Le journal de session affiche le texte de l’assistant avec didSendViaMessagingTool: false | Le modèle a répondu en privé au lieu d’appeler l’outil de message. Utilisez un modèle fiable pour les appels d’outils, ou définissez messages.groupChat.visibleReplies: "automatic" pour publier automatiquement. |
| Réponses DM manquantes | openclaw pairing list discord | Approuvez l’association DM ou ajustez la stratégie de DM. |
Slack
Signatures d’échec Slack
| Symptôme | Vérification la plus rapide | Correctif |
|---|
| Mode socket connecté, mais aucune réponse | openclaw channels status --probe | Vérifiez le jeton d’application + le jeton de bot et les portées requises ; surveillez botTokenStatus / appTokenStatus = configured_unavailable sur les configurations basées sur SecretRef. |
| DM bloqués | openclaw pairing list slack | Approuvez l’association ou assouplissez la stratégie de DM. |
| Message de canal ignoré | Vérifiez groupPolicy et la liste d’autorisation du canal | Autorisez le canal ou passez la stratégie à open. |
iMessage
Signatures d’échec iMessage
| Symptôme | Vérification la plus rapide | Correctif |
|---|
imsg manquant ou en échec hors macOS | openclaw channels status --probe --channel imessage | Exécutez OpenClaw sur le Mac Messages ou utilisez un wrapper SSH pour cliPath. |
| Envoi possible, mais pas de réception sur macOS | Vérifiez les autorisations de confidentialité macOS pour l’automatisation de Messages | Réaccordez les autorisations TCC et redémarrez le processus du canal. |
| Expéditeur DM bloqué | openclaw pairing list imessage | Approuvez l’association ou mettez à jour la liste d’autorisation. |
Signal
Signatures d’échec Signal
| Symptôme | Vérification la plus rapide | Correctif |
|---|
| Démon joignable, mais bot silencieux | openclaw channels status --probe | Vérifiez l’URL/le compte du démon signal-cli et le mode de réception. |
| DM bloqué | openclaw pairing list signal | Approuvez l’expéditeur ou ajustez la stratégie de DM. |
| Les réponses de groupe ne se déclenchent pas | Vérifiez la liste d’autorisation du groupe et les motifs de mention | Ajoutez l’expéditeur/le groupe ou assouplissez le filtrage. |
QQ Bot
Signatures d’échec QQ Bot
| Symptôme | Vérification la plus rapide | Correctif |
|---|
| Le bot répond “gone to Mars” | Vérifiez appId et clientSecret dans la configuration | Définissez les identifiants ou redémarrez le Gateway. |
| Aucun message entrant | openclaw channels status --probe | Vérifiez les identifiants sur la QQ Open Platform. |
| Voix non transcrite | Vérifiez la configuration du fournisseur STT | Configurez channels.qqbot.stt ou tools.media.audio. |
| Les messages proactifs n’arrivent pas | Vérifiez les exigences d’interaction de la plateforme QQ | QQ peut bloquer les messages initiés par le bot sans interaction récente. |
Matrix
Signatures d’échec Matrix
| Symptôme | Vérification la plus rapide | Correctif |
|---|
| Connecté, mais ignore les messages de salon | openclaw channels status --probe | Vérifiez groupPolicy, la liste d’autorisation du salon et le filtrage par mention. |
| DM non traités | openclaw pairing list matrix | Approuvez l’expéditeur ou ajustez la stratégie de DM. |
| Les salons chiffrés échouent | openclaw matrix verify status | Revérifiez l’appareil, puis vérifiez openclaw matrix verify backup status. |
| La restauration de sauvegarde est en attente/cassée | openclaw matrix verify backup status | Exécutez openclaw matrix verify backup restore ou relancez avec une clé de récupération. |
| La signature croisée/l’amorçage semble incorrect | openclaw matrix verify bootstrap | Réparez le stockage secret, la signature croisée et l’état de sauvegarde en un seul passage. |
Connexe
