Node.js

Node.js

OpenClaw requiere Node 22.14 o más reciente. Node 24 es el entorno 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 desees 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 versión predeterminada recomendada. Si imprime v22.14.x o superior, estás en la ruta compatible de 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 descargue 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 descargue el instalador de Windows desde nodejs.org.

Using a version manager (nvm, fnm, mise, asdf)

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

• fnm — rápido, multiplataforma
• nvm — muy utilizado en macOS/Linux
• mise — multiparadigma (Node, Python, Ruby, etc.)

Ejemplo con fnm:

fnm install 24
fnm use 24

Warning

Asegúrese de que su gestor de versiones se inicialice en el archivo de inicio de su shell (~/.zshrc o ~/.bashrc). Si no es así, es posible 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

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

1. Find your global npm prefix

   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