Problemes courants
Si vous n’avez que 2 minutes, utilisez cette page comme porte d’entrée de triage.Les 60 premieres secondes
Exécutez cette séquence exacte dans l’ordre :openclaw status→ affiche les canaux configurés et aucune erreur d’authentification évidente.openclaw status --all→ le rapport complet est présent et partageable.openclaw gateway probe→ la cible de passerelle attendue est joignable.openclaw gateway status→Runtime: runningetRPC probe: ok.openclaw doctor→ aucune erreur bloquante de config/service.openclaw channels status --probe→ les canaux indiquentconnectedouready.openclaw logs --follow→ activité régulière, sans erreurs fatales répétées.
Arbre de décision
Aucune réponse
Aucune réponse
Runtime: runningRPC probe: ok- Votre canal apparaît
connected/readydanschannels status --probe - L’expéditeur apparaît approuvé (ou la politique DM est ouverte/allowlist)
drop guild message (mention required→ le filtrage par mention a bloqué le message dans Discord.pairing request→ l’expéditeur n’est pas approuvé et attend l’approbation d’appairage en DM.blocked/allowlistdans les logs du canal → l’expéditeur, la salle ou le groupe est filtré.
Le tableau de bord ou l’UI de contrôle ne se connecte pas
Le tableau de bord ou l’UI de contrôle ne se connecte pas
Dashboard: http://...est affiché dansopenclaw gateway statusRPC probe: ok- Aucune boucle d’authentification dans les logs
device identity required→ HTTP/contexte non sécurisé ne peut pas compléter l’authentification de l’appareil.unauthorized/ reconnect loop → token/mot de passe incorrect ou mode d’authentification incompatible.gateway connect failed:→ l’UI cible la mauvaise URL/port ou la passerelle est injoignable.
La passerelle ne démarre pas ou le service est installé mais non lancé
La passerelle ne démarre pas ou le service est installé mais non lancé
Service: ... (loaded)Runtime: runningRPC probe: ok
Gateway start blocked: set gateway.mode=local→ le mode gateway est unset/remote.refusing to bind gateway ... without auth→ bind non-loopback sans token/mot de passe.another gateway instance is already listeningouEADDRINUSE→ port déjà utilisé.
Le canal se connecte mais les messages ne circulent pas
Le canal se connecte mais les messages ne circulent pas
- Le transport du canal est connecté.
- Les vérifications d’appairage/allowlist passent.
- Les mentions sont détectées lorsque requis.
mention required→ le filtrage par mention de groupe a bloqué le traitement.pairing/pending→ l’expéditeur DM n’est pas encore approuvé.not_in_channel,missing_scope,Forbidden,401/403→ problème de token/permissions du canal.
Cron ou heartbeat ne s’est pas déclenché ou n’a pas été livré
Cron ou heartbeat ne s’est pas déclenché ou n’a pas été livré
cron.statusindique activé avec un prochain réveil.cron runsaffiche des entrées récentesok.- Le heartbeat est activé et pas en dehors des heures actives.
cron: scheduler disabled; jobs will not run automatically→ cron est désactivé.heartbeat skippedavecreason=quiet-hours→ en dehors des heures actives configurées.requests-in-flight→ voie principale occupée ; le réveil du heartbeat a été différé.unknown accountId→ le compte cible du heartbeat n’existe pas.
Le nœud est appairé mais un outil camera/canvas/screen/exec échoue
Le nœud est appairé mais un outil camera/canvas/screen/exec échoue
- Le nœud est listé comme connecté et appairé pour le rôle
node. - La capacité existe pour la commande invoquée.
- L’état de permission est accordé pour l’outil.
NODE_BACKGROUND_UNAVAILABLE→ mettre l’application du nœud au premier plan.*_PERMISSION_REQUIRED→ permission OS refusée/manquante.SYSTEM_RUN_DENIED: approval required→ approbation exec en attente.SYSTEM_RUN_DENIED: allowlist miss→ commande non présente dans l’allowlist exec.
L’outil navigateur échoue
L’outil navigateur échoue