Node.js

OpenClaw requiere Node 22.16 o superior. Node 24 es el runtime por defecto y recomendado para instalaciones, CI y flujos de release. 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 quieras configurar Node tú mismo y asegurarte de que todo está bien conectado (versiones, PATH, instalaciones globales).

Comprueba tu versión

node -v

Si muestra v24.x.x o superior, estás en la versión recomendada. Si muestra v22.16.x o superior, estás en la ruta compatible Node 22 LTS, pero recomendamos actualizar a Node 24 cuando te 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

macOS

**Homebrew** (recomendado):

```bash
brew install node
```

O descarga el instalador de macOS desde [nodejs.org](https://nodejs.org/).

Linux

**Ubuntu / Debian:**

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

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

Windows

**winget** (recomendado):

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

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

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

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

Ejemplo con fnm:

fnm install 24
fnm use 24

Advertencia: Asegúrate de que tu gestor de versiones esté inicializado en tu archivo de inicio del shell (~/.zshrc o ~/.bashrc). Si no lo está, openclaw podría 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`

Casi siempre significa que el directorio global de binarios de npm no está en tu PATH.

Paso 1: Encuentra tu prefijo global de npm

```bash
npm prefix -g
```

Paso 2: Comprueba si está en tu PATH

```bash
echo "$PATH"
```

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

Paso 3: Agrégalo a tu archivo de inicio del shell

  #### macOS / Linux
    Agrega a `~/.zshrc` o `~/.bashrc`:

    ```bash
    export PATH="$(npm prefix -g)/bin:$PATH"
    ```

    Luego abre una nueva terminal (o ejecuta `rehash` en zsh / `hash -r` en bash).

  #### Windows
    Agrega la salida de `npm prefix -g` al PATH del sistema vía Configuración → Sistema → Variables de entorno.

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

Si ves errores EACCES, cambia el prefijo global de npm a un directorio con permisos de escritura:

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.