--- title: "Requisitos de OpenClaw y errores comunes al instalar" excerpt: "Los requisitos reales de OpenClaw (Node, RAM, sistema operativo) y cómo resolver los errores más comunes al instalarlo: Node demasiado viejo, el daemon que no arranca, el puerto 18789 y la API key." date: "2026-06-16T12:30:00.000Z" lastModified: "2026-06-19T11:00:00.000Z" category: "OpenClaw" tech_article: true seo_title: "Requisitos de OpenClaw + errores comunes al instalar (2026)" seo_description: "Requisitos mínimos de OpenClaw (Node 22.19+/24, 4 GB RAM, macOS/Linux/Windows) y soluciones a los errores comunes al instalar: Node viejo, daemon, puerto 18789 y API key." author: name: "Angel Cruz" picture: "https://angelcruzdevcdn.nyc3.cdn.digitaloceanspaces.com/images/me/angel-cruz.png" ogImage: url: "https://angelcruzdevcdn.nyc3.cdn.digitaloceanspaces.com/content/5/01KFVJFYG53S1S5DCMGREM3CC2.png" --- Antes de instalar [OpenClaw](/post/clawdbot-asistente-ia-personal-open-source) 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](/post/como-instalar-openclaw-guia-completa). ## 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](/post/instalar-openclaw-en-raspberry-pi). ## Antes de nada: `openclaw doctor` Ante cualquier falla, el primer comando que debes correr es el diagnóstico integrado: ```bash openclaw doctor ``` Revisa la versión de Node, el estado del gateway, los puertos, los permisos y la configuración del proveedor, y te dice **exactamente qué falta** en vez de fallar en silencio. La mayoría de los errores de abajo los detecta `doctor` antes de que tengas que investigar a mano. Para ver si el gateway está corriendo, suma: ```bash openclaw gateway status ``` ## 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: ```bash node --version ``` Si es menor, actualiza a Node 24 (con [fnm](https://github.com/Schniz/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: ```bash openclaw status systemctl status openclaw journalctl -u openclaw -f ``` En 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: ```bash openclaw onboard ``` ### 5. 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](/post/instalar-openclaw-en-windows). ### 7. En Docker no conecta con un modelo local Si corres OpenClaw en [Docker](/post/instalar-openclaw-con-docker-compose) y apuntas tu modelo local a `127.0.0.1`, fallará: dentro del contenedor esa dirección es el contenedor mismo, no tu host. Apunta el proveedor a `host.docker.internal` (y en Linux agrega `extra_hosts: ["host.docker.internal:host-gateway"]` al compose). ### 8. La instalación con pnpm no compila Si instalas con pnpm de forma global, los scripts de build de algunas dependencias quedan bloqueados por defecto. Habilítalos una vez con: ```bash pnpm approve-builds -g ``` Para el gateway, de todos modos, la documentación recomienda Node por sobre otros runtimes; bun sirve para la CLI. ## 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. ### ¿Hay un comando para diagnosticar la instalación? Sí: `openclaw doctor` revisa Node, gateway, puertos, permisos y configuración, y te indica qué falta. Es el primer comando a correr ante cualquier problema. ## 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](/post/como-instalar-openclaw-guia-completa). ## Fuente - [Documentación oficial de OpenClaw](https://docs.openclaw.ai/install) --- ## Sitemap Índice completo del sitio: [/sitemap.md](https://www.angelcruz.dev/sitemap.md) Canónico HTML: [https://www.angelcruz.dev/post/requisitos-y-errores-comunes-openclaw](https://www.angelcruz.dev/post/requisitos-y-errores-comunes-openclaw)