Errores comunes de instalación de OpenClaw y cómo solucionarlos

Guía de solución de problemas de instalación de OpenClaw

Una publicación reciente en r/openclaw aborda errores recurrentes de instalación y ejecución para la herramienta OpenClaw, proporcionando comandos y soluciones específicas.

Problemas clave y soluciones

"instalado pero openclaw no se puede encontrar"

Esto ocurre cuando el directorio bin global de npm no está en tu PATH. El binario existe pero no se puede encontrar.

• Ejecuta npm prefix -g para encontrar tu prefijo global.
• Añade <prefix>/bin a tu $PATH en .bashrc o .zshrc.
• Recarga tu shell, entonces openclaw --version debería funcionar.

"EACCES: permiso denegado" en la instalación

Este es un problema de permisos con el directorio global predeterminado de npm, a menudo propiedad de root.

• No uses sudo.
• Configura un prefijo propiedad del usuario en su lugar:

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

• Añade la exportación a tu configuración de shell y vuelve a ejecutar la instalación sin sudo.

Fallos silenciosos con versiones antiguas de Node.js

OpenClaw requiere Node.js 22+. Las versiones anteriores pueden instalarse sin error pero producen un binario que falla en tiempo de ejecución.

• Siempre verifica node --version primero.

"ioctl inapropiado para el dispositivo"

Este es un problema de TTY, común en contenedores Docker o entornos CI sin una terminal real.

• Ejecuta openclaw onboard --non-interactive --accept-risk para omitir el asistente interactivo.

Complemento de Telegram atascado como "no disponible"

Si una instalación rota anterior dejó el complemento de Telegram en un estado parcialmente configurado, puede atascarse.

• Ejecuta openclaw doctor --fix para limpiar el estado.

Nota sobre "se requiere emparejamiento de conexión de puerta de enlace"

Este mensaje no es un error de instalación. Se relaciona con la política de DM, donde OpenClaw requiere emparejamiento manual antes de responder a DMs por defecto. Consulta la documentación de OpenClaw sobre configuración de canales.