Configuración de Node.js para OpenClaw

¿Alguna vez has intentado ejecutar un comando y te has encontrado con un error de versión o un mensaje de “command not found”? Configurar el entorno de ejecución suele ser el paso más tedioso antes de empezar a construir algo interesante, especialmente cuando las rutas globales o los permisos de carpeta deciden no cooperar.

Aquí tienes los pasos para dejar Node.js listo y evitar que la configuración del sistema bloquee tu progreso.

Requisitos previos

Para que OpenClaw funcione correctamente, solo necesitas cumplir con este requisito:

• Node 22 o superior

Inicio rápido

Sigue estos pasos para instalar o verificar tu versión de Node.js en menos de 5 minutos.

1. Verifica tu versión actual

Abre tu terminal y ejecuta:

node -v

Si el resultado es v22.x.x o una versión más reciente, ya puedes empezar. Si no tienes Node.js o la versión es antigua, elige un método de instalación abajo.

2. Instala Node.js según tu sistema

macOS Usa Homebrew (recomendado):

brew install node

O descarga el instalador oficial desde nodejs.org.

Linux En Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

En Fedora / RHEL:

sudo dnf install nodejs

Windows Usa winget (recomendado):

winget install OpenJS.NodeJS.LTS

O usa Chocolatey:

choco install nodejs-lts

3. Gestores de versiones (Opcional)

Si necesitas cambiar entre versiones de Node.js rápidamente, puedes usar estas herramientas:

• fnm: rápido y multiplataforma.
• nvm: el estándar para macOS/Linux.
• mise: para gestionar múltiples lenguajes.

Ejemplo con fnm:

fnm install 22
fnm use 22

Aviso: Asegúrate de inicializar tu gestor de versiones en el archivo de configuración de tu shell (~/.zshrc o ~/.bashrc). Si no lo haces, es posible que el sistema no encuentre openclaw en nuevas sesiones porque el PATH no incluirá el directorio bin de Node.js.

Solución de problemas

Error: openclaw: command not found

Esto sucede cuando el directorio bin global de npm no está en tu PATH.

1. Busca tu prefijo global de npm:

   npm prefix -g

2. Revisa si está en tu PATH:

   echo "$PATH"

   Busca <npm-prefix>/bin (macOS/Linux) o <npm-prefix> (Windows) en el resultado.
3. Agrégalo a tu archivo de configuración:
   • macOS / Linux: Añade esto a ~/.zshrc o ~/.bashrc:

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

     Luego abre una nueva terminal.
   • Windows: Agrega el resultado de npm prefix -g a las Variables de Entorno del sistema.

Errores de permisos en npm install -g (Linux)

Si ves errores tipo EACCES, cambia el prefijo global de npm a una carpeta donde tu usuario tenga permisos:

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

Para que el cambio sea permanente, añade la línea export PATH=... a tu archivo ~/.bashrc o ~/.zshrc.

---

¿Necesitas ayuda personalizada con tu entorno? Prueba nuestro AI Setup Assistant.

What’s Next:

• Métodos de instalación de OpenClaw
• Configuración de variables de entorno