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

macOS
Linux
Windows

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/).
````

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 — 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.

Find your global npm prefix

npm prefix -g

Check if it's on your PATH

echo "$PATH"

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

Add it to your shell startup file

macOS / Linux
Windows

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

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

Luego abra una nueva terminal (o ejecute rehash en zsh / hash -r en bash).

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

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.

Ayuda

Comunidad

Entorno y depuración

Entorno de ejecución Node

Aspectos internos de compactación

Configuración para desarrolladores

Metadatos de documentación

Node.js

Node.js

Verifique su versión

Instalar Node

Solución de problemas

`openclaw: command not found`

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

​Node.js

​Verifique su versión

​Instalar Node

​Solución de problemas

​openclaw: command not found

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

Node.js

Verifique su versión

Instalar Node

Solución de problemas

`openclaw: command not found`

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