Skip to main content
OpenClaw requiere Node 22.22.3+, Node 24.15+ o Node 25.9+. Node 24 es el entorno de ejecución predeterminado y recomendado para instalaciones, CI y flujos de trabajo de publicación; Node 22 sigue siendo compatible mediante la línea LTS activa. Node 23 no es compatible. El script de instalación detecta e instala Node automáticamente; use esta página cuando quiera configurar Node por su cuenta (versiones, PATH, instalaciones globales).

​
Comprobar la versión

v24.15.0 o una versión 24.x posterior es la opción predeterminada recomendada. v22.22.3 o una versión 22.x posterior es la ruta compatible de Node 22 LTS; Node v25.9.0+ también es compatible. Node 23 no es compatible. Si Node no está instalado o se encuentra fuera del intervalo compatible, elija uno de los métodos de instalación siguientes.

​
Instalar Node

Homebrew (recomendado):
También puede descargar el instalador para macOS desde nodejs.org.
Los gestores de versiones permiten cambiar fácilmente entre versiones de Node. Algunas opciones populares son:
  • fnm - rápido y multiplataforma
  • nvm - muy utilizado en macOS/Linux
  • mise - políglota (Node, Python, Ruby, etc.)
Ejemplo con fnm:
Inicialice el gestor de versiones en el archivo de inicio del shell (~/.zshrc o ~/.bashrc). Si omite este paso, es posible que openclaw no se encuentre en las nuevas sesiones de terminal porque PATH no incluirá el directorio bin de Node.

​
Solución de problemas

​
openclaw: command not found

Esto casi siempre significa que el directorio bin global de npm no está en PATH.
1

Buscar el prefijo global de npm

2

Comprobar si está en PATH

Busque <npm-prefix>/bin (macOS/Linux) o <npm-prefix> (Windows) en la salida.
3

Añadirlo al archivo de inicio del shell

Añádalo a ~/.zshrc o ~/.bashrc:
A continuación, abra una terminal nueva (o ejecute rehash en zsh / hash -r en bash).

​
Errores de permisos en npm install -g (Linux)

Si aparecen errores EACCES, cambie el prefijo global de npm a un directorio en el que el usuario tenga permisos de escritura:
Añada la línea export PATH=... a ~/.bashrc o ~/.zshrc para que el cambio sea permanente.

​
Contenido relacionado