Node.js¶

OpenClaw requiere Node 22 o superior. El script de instalación detectará e instalará Node automáticamente — esta página es para cuando desea configurar Node por su cuenta y asegurarse de que todo esté conectado correctamente (versiones, PATH, instalaciones globales).

Verifique su versión¶

node -v

Si esto imprime v22.x.x o superior, está listo. Si Node no está instalado o la versión es demasiado antigua, elija un método de instalación a continuación.

Instalar Node¶

Homebrew (recomendado):

````
```bash
brew install node
```

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

Ubuntu / Debian:

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

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

O use un gestor de versiones (vea abajo).
````

winget (recomendado):

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

**Chocolatey:**

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

O descargue el instalador de Windows desde [nodejs.org](https://nodejs.org/).
````

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

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

Ejemplo con fnm:

fnm install 22
fnm use 22

Asegúrese de que su gestor de versiones esté inicializado en el archivo de inicio de su 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 su PATH.

bash npm prefix -g bash echo "$PATH"

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

Agregue a ~/.zshrc o ~/.bashrc:

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

        Luego abra una nueva terminal (o ejecute `rehash` en zsh / `hash -r` en bash).
      </Tab>
      <Tab title="Windows">
        Agregue la salida de `npm prefix -g` a su PATH del sistema mediante Configuración → Sistema → Variables de entorno.
      </Tab>
    </Tabs>
    ```

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

Si ve errores EACCES, cambie el prefijo global de npm a un directorio con permisos de escritura para el usuario:

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

Agregue la línea export PATH=... a su ~/.bashrc o ~/.zshrc para que sea permanente.