Install overview
Node.js
OpenClaw requiere Node 22.16 o posterior. Node 24 es el runtime 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 quieres configurar Node por tu cuenta 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 usando el valor predeterminado recomendado. Si imprime v22.16.x o superior, estás en la ruta compatible de Node 22 LTS, pero aun así 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
macOS
Homebrew (recomendado):
brew install node
O descarga el instalador de macOS desde nodejs.org.
Linux
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 (consulta abajo).
Windows
winget (recomendado):
winget install OpenJS.NodeJS.LTS
Chocolatey:
choco install nodejs-lts
O descarga el instalador de Windows desde nodejs.org.
Uso de un gestor de versiones (nvm, fnm, mise, asdf)
Los gestores de versiones te 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 24
fnm use 24
Solución de problemas
openclaw: command not found
Esto casi siempre significa que el directorio bin global de npm no está en tu PATH.
Encuentra tu prefijo global de npm
npm prefix -g
Verifica si está en tu PATH
echo "$PATH"
Busca <npm-prefix>/bin (macOS/Linux) o <npm-prefix> (Windows) en la salida.
Agrégalo al archivo de inicio de tu shell
macOS / Linux
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).
Windows
Agrega la salida de npm prefix -g al PATH del sistema mediante 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 en el que el usuario pueda escribir:
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 hacerla permanente.
Relacionado
- Resumen de instalación - todos los métodos de instalación
- Actualización - mantener OpenClaw al día
- Primeros pasos - primeros pasos después de la instalación