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

brew install 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"

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.

Diagnostics FlagsSession Management Deep Dive