Requisitos de OpenClaw y errores comunes al instalar
Antes de instalar OpenClaw conviene saber qué pide de verdad, y qué hacer cuando algo falla. Este es el resumen de requisitos y los problemas más comunes al instalarlo. Para los pasos por plataforma, está la guía de instalación de OpenClaw.
Requisitos mínimos
| Requisito | Detalle |
|---|---|
| Node.js | 22.19 o superior (la documentación recomienda Node 24) |
| Sistema operativo | macOS 15+, Linux de 64 bits, o Windows 10 20H2+/11 |
| RAM | 4 GB mínimo; 8 GB para uso intensivo |
| Proveedor de IA | Una API key (Claude, OpenAI o un modelo local) |
El script de instalación oficial resuelve Node por ti, así que en la mayoría de los casos solo necesitas el sistema operativo soportado y la API key. Para correrlo en hardware chico, mira la guía de OpenClaw en Raspberry Pi.
Errores comunes y cómo resolverlos
1. El comando falla o pide una versión de Node más nueva
Es el problema número uno: tienes una versión de Node anterior a la 22.19. Verifica:
node --versionSi es menor, actualiza a Node 24 (con fnm o NodeSource) o reinstala con el script oficial, que instala la versión correcta automáticamente.
2. El daemon no arranca o OpenClaw no responde tras reiniciar
Si registraste el servicio con --install-daemon pero el agente no aparece, revisa su estado y sus logs. En Linux:
openclaw status
systemctl status openclaw
journalctl -u openclaw -fEn macOS el daemon corre con launchd. Si quedó mal registrado, vuelve a correr openclaw onboard --install-daemon.
3. El puerto 18789 está ocupado
El gateway escucha en 127.0.0.1:18789. Si otro proceso ya usa ese puerto, OpenClaw no levanta. Libera el puerto o configura el gateway en otro durante el onboarding.
4. No conecta con el modelo de IA
Casi siempre es la API key sin configurar o vencida. Vuelve a correr el wizard y carga la clave del proveedor:
openclaw onboard5. En macOS pide permisos de administrador
Es esperado: la documentación oficial avisa que "first run may need an Administrator for Homebrew". La primera ejecución puede necesitar permisos de administrador para instalar dependencias con Homebrew. Concédelos esa vez y listo.
6. En Windows el script no corre
El install.sh es un script bash y no corre en PowerShell. En Windows usa el instalador de PowerShell, la app nativa Windows Hub o WSL2: lo explico en la guía de OpenClaw en Windows.
Preguntas frecuentes
¿Cuál es el requisito mínimo de RAM?
4 GB para funcionar; 8 GB recomendados si vas a tener varios canales y skills activos a la vez.
¿Node 22 o Node 24?
El mínimo es Node 22.19; la documentación recomienda Node 24. Si dejas que el script instale Node, ya elige una versión compatible.
¿Funciona sin conexión a internet?
OpenClaw el agente corre local, pero la inferencia la hace tu proveedor de IA en la nube (Claude, OpenAI). Sin internet solo funciona si configuraste un modelo local.
Cierre
La mayoría de los problemas al instalar OpenClaw se reducen a tres cosas: una versión de Node vieja, el daemon mal registrado o la API key sin configurar. Con los requisitos claros y estos chequeos, la instalación es directa. Los pasos por plataforma están en la guía completa de OpenClaw.