Saltar al contenido principal

​
Node.js

OpenClaw requiere Node 22.14 o posterior. Node 24 es el runtime predeterminado y recomendado para instalaciones, CI y flujos de trabajo de versiones. Node 22 sigue siendo compatible mediante la línea LTS activa. El script de instalación detectará e instalará Node automáticamente; esta página es para cuando quieras configurar Node por tu cuenta y asegurarte de que todo esté correctamente conectado (versiones, PATH, instalaciones globales).

​
Comprueba tu versión

node -v
Si esto muestra v24.x.x o superior, estás usando el valor predeterminado recomendado. Si muestra v22.14.x o superior, estás en la ruta compatible de Node 22 LTS, pero aun así recomendamos actualizar a Node 24 cuando te resulte conveniente. Si Node no está instalado o la versión es demasiado antigua, elige uno de los métodos de instalación de abajo.

​
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, multiplataforma
  • nvm — muy usado en macOS/Linux
  • mise — políglota (Node, Python, Ruby, etc.)
Ejemplo con fnm:
fnm install 24
fnm use 24
Asegúrate de que tu gestor de versiones esté inicializado en el archivo de inicio de tu shell (~/.zshrc o ~/.bashrc). Si no lo está, puede que openclaw no se encuentre en nuevas sesiones de terminal porque el PATH no incluirá el directorio bin de Node.

​
Solución de problemas

​
openclaw: command not found

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