Runtime de Node
Node.js
OpenClaw requiere Node 22 o más reciente. El script de instalación detectará e instalará Node automáticamente — esta página es para cuando quieres configurar Node tú mismo y asegurarte de que todo esté conectado correctamente (versiones, PATH, instalaciones globales).
Verifica tu versión
node -v
Si esto imprime v22.x.x o superior, estás listo. Si Node no está instalado o la versión es muy antigua, elige un método de instalación a continuación.
Instalar Node
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 22
fnm use 22
Asegúrate de que tu gestor de versiones esté inicializado en tu archivo de inicio del shell (~/.zshrc o ~/.bashrc). Si no lo está, es posible que openclaw no se encuentre en nuevas sesiones de terminal porque el PATH no incluirá el directorio bin de Node.
Solución de problemas
openclaw: comando no encontrado
Esto casi siempre significa que el directorio bin global de npm no está en tu PATH.
Paso 1: Encuentra tu prefijo global de npm
npm prefix -g
Paso 2: Verifica si está en tu PATH
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
export PATH="$(npm prefix -g)/bin:$PATH"
Agrega la salida de npm prefix -g a tu PATH del sistema a través de 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 escribible por el usuario:
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.