Saltar al contenido principal

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

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

echo "$PATH"

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

Add it to your shell startup file

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

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