Node.js

OpenClaw requiere Node 22.19 o más reciente. Node 24 es el tiempo de ejecución predeterminado y recomendado para instalaciones, CI y flujos de trabajo de lanzamiento. Node 22 sigue siendo compatible a través de la línea LTS activa. El script de instalación detectará e instalará Node automáticamente; esta página es para cuando deseas configurar Node tú mismo y asegurarte de que todo esté conectado correctamente (versiones, PATH, instalaciones globales).

Verifica tu versión

node -v

Si esto imprime v24.x.x o superior, estás en la opción predeterminada recomendada. Si imprime v22.19.x o superior, estás en la ruta compatible Node 22 LTS, pero aún recomendamos actualizar a Node 24 cuando sea conveniente. Si Node no está instalado o la versión es demasiado antigua, elige un método de instalación a continuación.

Instalar Node

macOSLinuxWindows

Homebrew (recomendado):

brew install node

O descarga el instalador de macOS desde nodejs.org.

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / RHEL:

sudo dnf install nodejs

O usa un gestor de versiones (ver abajo).

winget (recomendado):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

O descarga el instalador de Windows desde nodejs.org.

Usar un gestor de versiones (nvm, fnm, mise, asdf)

Los gestores de versiones te permiten cambiar fácilmente entre versiones de Node. Opciones populares:

• fnm - rápido, multiplataforma
• nvm - ampliamente utilizado en macOS/Linux
• mise - políglota (Node, Python, Ruby, etc.)

Ejemplo con fnm:

fnm install 24
fnm use 24

Warning

Asegúrate de que tu gestor de versiones esté inicializado en tu archivo de inicio de shell (~/.zshrc o ~/.bashrc). Si no lo está, openclaw puede no encontrarse en nuevas sesiones de terminal porque el 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 `

   /bin(macOS/Linux) o

   ` (Windows) en la salida.

3. Agrégalo a tu archivo de inicio de shell

   macOS / LinuxWindows

   Agrega 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).

   Agrega la salida de npm prefix -g a tu PATH del sistema mediante Configuración → Sistema → Variables de entorno.

Errores de permiso en npm install -g (Linux)

Si ves errores de 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"

Agrega la línea export PATH=... a tu ~/.bashrc o ~/.zshrc para hacerlo permanente.

Relacionado

• Resumen de instalación - todos los métodos de instalación
• Actualización - mantener OpenClaw actualizado
• Primeros pasos - primeros pasos después de la instalación