Saltar al contenido principal
OpenClaw requiere Node 22.19+, Node 23.11+ o Node 24+. Node 24 es el runtime predeterminado y recomendado para instalaciones, CI y flujos de trabajo de lanzamiento; Node 22 sigue siendo compatible mediante la línea LTS activa. El script de instalación detecta e instala Node automáticamente: usa esta página cuando quieras configurar Node por tu cuenta (versiones, PATH, instalaciones globales).

​
Comprueba tu versión

node -v
v24.x.x o superior es el valor predeterminado recomendado. v22.19.x o superior es la ruta compatible para Node 22 LTS (actualiza a Node 24 cuando te convenga). Las compilaciones de Node 23 anteriores a v23.11.0 no son compatibles. Si falta Node o está fuera del rango compatible, elige un método de instalación a continuación.

​
Instalar Node

Homebrew (recomendado):
brew install node
O descarga el instalador de macOS desde nodejs.org.
Los gestores de versiones te permiten cambiar fácilmente entre versiones de Node. Opciones populares:
  • fnm - rápido y multiplataforma
  • nvm - ampliamente usado en macOS/Linux
  • mise - políglota (Node, Python, Ruby, etc.)
Ejemplo con fnm:
fnm install 24
fnm use 24
Inicializa tu gestor de versiones en el archivo de inicio de tu shell (~/.zshrc o ~/.bashrc). Si omites esto, puede que openclaw no se encuentre en 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 tu PATH.
1

Encuentra tu prefijo global de npm

npm prefix -g
2

Comprueba si está en tu PATH

echo "$PATH"
Busca <npm-prefix>/bin (macOS/Linux) o <npm-prefix> (Windows) en la salida.
3

Añádelo al archivo de inicio de tu shell

Añádelo a ~/.zshrc o ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Luego abre una nueva terminal (o ejecuta rehash en zsh / hash -r en bash).

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

Si ves errores EACCES, cambia el prefijo global de npm a un directorio escribible por el usuario: 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
Añade la línea export PATH=... a tu ~/.bashrc o ~/.zshrc para que sea permanente.

​
Relacionado