Erreurs courantes d'installation d'OpenClaw et comment les résoudre

Guide de dépannage pour l'installation d'OpenClaw

Un post récent sur r/openclaw aborde les erreurs récurrentes d'installation et d'exécution de l'outil OpenClaw, en fournissant des commandes et des correctifs spécifiques.

Problèmes clés et solutions

"installé mais openclaw n'est pas détectable"

Cela se produit lorsque le répertoire bin global de npm n'est pas dans votre PATH. Le binaire existe mais ne peut pas être trouvé.

• Exécutez npm prefix -g pour trouver votre préfixe global.
• Ajoutez <prefix>/bin à votre $PATH dans .bashrc ou .zshrc.
• Rechargez votre shell, puis openclaw --version devrait fonctionner.

"EACCES: permission refusée" lors de l'installation

Il s'agit d'un problème de permissions avec le répertoire global par défaut de npm, souvent détenu par root.

• N'utilisez pas sudo.
• Configurez plutôt un préfixe appartenant à l'utilisateur :

  mkdir -p ~/.npm-global
  npm config set prefix '~/.npm-global'
  export PATH="$HOME/.npm-global/bin:$PATH"

• Ajoutez l'export à votre configuration shell et relancez l'installation sans sudo.

Défaillances silencieuses avec une ancienne version de Node.js

OpenClaw nécessite Node.js 22+. Les versions plus anciennes peuvent s'installer sans erreur mais produire un binaire qui plante à l'exécution.

• Vérifiez toujours node --version en premier.

"inappropriate ioctl for device"

Il s'agit d'un problème TTY, courant dans les conteneurs Docker ou les environnements CI sans terminal réel.

• Exécutez openclaw onboard --non-interactive --accept-risk pour ignorer l'assistant interactif.

Plugin Telegram bloqué à l'état "non disponible"

Si une installation précédente défectueuse a laissé le plugin Telegram dans un état partiellement configuré, il peut rester bloqué.

• Exécutez openclaw doctor --fix pour effacer l'état.

Note sur "gateway connect pairing required"

Ce message n'est pas une erreur d'installation. Il concerne la politique DM, où OpenClaw nécessite un appairage manuel avant de répondre aux DM par défaut. Consultez la documentation OpenClaw sur la configuration des canaux.