OpenClaw

Cómo instalar OpenClaw paso a paso

AutorAngel Cruz
Actualizado
Publicado
Lectura6 min de lectura
Cómo instalar OpenClaw paso a paso

Para instalar OpenClaw, la forma más rápida es el script oficial: abre tu terminal y corre curl -fsSL https://openclaw.ai/install.sh | bash. Detecta tu sistema operativo, instala Node.js si falta y deja OpenClaw listo en menos de 5 minutos.

Esta página es el mapa: el método universal que funciona en cualquier sistema, la alternativa manual con npm, y desde dónde seguir cuando tu caso tiene particularidades (un servidor 24/7, un contenedor, una Raspberry Pi).

Si buscabas "instalar Clawdbot": estás en el sitio correcto. El proyecto se llamó Clawdbot, luego Moltbot durante tres días, y desde el 30 de enero de 2026 se llama OpenClaw. Es el mismo software. La historia completa del rebrand está aparte.

Qué es OpenClaw

Un asistente de IA open source que corre en tu máquina, no en la nube. A diferencia de ChatGPT o Claude en el navegador, se ejecuta como proceso en segundo plano (daemon), puede ejecutar comandos en tu sistema, se conecta a canales de mensajería (Slack, Discord, Telegram, WhatsApp, Teams) y admite tanto modelos cloud como locales.

Lo creó Peter Steinberger en noviembre de 2025. En febrero de 2026 anunció su incorporación a OpenAI y el traslado del proyecto a una fundación open source para garantizar su continuidad.

Si todavía estás decidiendo si te sirve, la comparación honesta está en OpenClaw frente a Zapier. Aquí damos por hecho que ya te decidiste.

Requisitos mínimos

Node.js 22.22.3+, 24.15+ o 25.9+ (la documentación recomienda Node 26), macOS, Linux o Windows 10/11, al menos 4 GB de RAM y una API key de un proveedor de IA, salvo que vayas a usar modelos locales.

Fíjate en el número de parche: no basta con "tener Node 22", hace falta la 22.22.3. Es un requisito con forma de trampa, porque un node --version que devuelve v22.14 parece cumplir y no cumple.

El script oficial resuelve Node por ti, así que en la mayoría de los casos solo necesitas el sistema operativo y la API key. Las versiones exactas por sistema están en requisitos de OpenClaw y errores comunes.

Instalar OpenClaw con el script oficial

curl -fsSL https://openclaw.ai/install.sh | bash

El script detecta tu sistema, instala Node.js si no está, instala OpenClaw globalmente, lanza el wizard openclaw onboard y registra el daemon para que el agente siga vivo en segundo plano.

El wizard te va a preguntar cuatro cosas: la API key del proveedor (Claude, OpenAI o un modelo local), el puerto del gateway local (18789 por defecto), los canales de mensajería que quieres conectar y las skills que habilitas de entrada. Todo eso se puede cambiar después.

Instalar OpenClaw con npm

Si prefieres control sobre cada paso, o ya tienes tu Node.js como lo quieres:

npm install -g openclaw@latest
openclaw onboard --install-daemon

El flag --install-daemon registra OpenClaw como servicio systemd en Linux y con launchd en macOS, de forma que sobrevive a los reinicios. Sin ese flag tienes OpenClaw instalado, pero tendrás que levantarlo a mano cada vez.

Elige tu ruta según dónde lo vas a correr

El script de arriba funciona en cualquiera de estos sistemas. Estas guías son para lo que el script no puede resolver por ti: qué modelo de hardware sirve, cómo dejarlo 24/7, qué persiste y qué no.

Dónde lo instalas Qué añade Guía
Windows 10/11 Tres vías oficiales, dos de ellas nativas, no solo WSL2 Instalar OpenClaw en Windows
Ubuntu Servicio systemd 24/7 y acceso remoto seguro Instalar OpenClaw en Ubuntu
Docker Aislamiento, volúmenes que persisten, health checks Instalar OpenClaw con Docker Compose
Raspberry Pi Qué modelo sirve (y cuál no), OS de 64 bits, bajo consumo Instalar OpenClaw en Raspberry Pi

Verificar que quedó bien instalado

openclaw --version
openclaw status

El primero confirma la versión instalada, el segundo te dice si el daemon está corriendo. Tu configuración vive en ~/.openclaw/openclaw.json, y ahí es donde después vas a tocar el modelo, el puerto del gateway, los canales y los permisos de comandos.

Un ajuste que sí conviene hacer temprano: OpenClaw ejecuta comandos con tus permisos de usuario, así que define listas de comandos permitidos y bloqueados, y nunca lo corras como root.

{
  "security": {
    "allowedCommands": ["git", "npm", "docker"],
    "blockedCommands": ["rm -rf /", "dd", "mkfs"]
  }
}

Actualizar OpenClaw

npm update -g openclaw
openclaw restart

Si lo instalaste con Docker Compose, la actualización va por docker compose pull y está explicada en su guía.

Si algo falla

El primer comando ante cualquier problema es el diagnóstico integrado:

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 qué falta en vez de fallar en silencio. Con eso salen la mayoría de los fallos: Node demasiado viejo, el daemon que no arranca tras reiniciar, el puerto 18789 ocupado o la API key mal configurada.

Cada uno de esos errores, con su causa y su solución, está en requisitos de OpenClaw y errores comunes.

Preguntas frecuentes

¿Cuánto tarda la instalación de OpenClaw?

Menos de 5 minutos con el script oficial en una conexión normal, contando la descarga de Node.js si no lo tenías. La configuración posterior (API key y canales) lleva otros 5.

¿OpenClaw es gratis?

Sí, es open source y gratuito. Lo que pagas es el consumo de API de tu proveedor de IA. Con modelos locales vía Ollama o llama.cpp no hay ese coste, pero necesitas hardware que los mueva.

¿Necesito WSL2 para instalar OpenClaw en Windows?

No. Hay tres caminos oficiales y dos son nativos: el instalador de PowerShell y la app Windows Hub. WSL2 es la tercera opción, útil si quieres el entorno Linux con systemd. Los tres están comparados en la guía de Windows.

¿Puedo usar OpenClaw sin conexión a internet?

Sí, con modelos locales. Necesitas hardware potente, con GPU preferiblemente, para que la experiencia sea usable.

¿Cuánta RAM necesita?

Mínimo 4 GB, recomendado 8 GB. Con modelos cloud el proceso ronda los 300 MB de RAM. Con modelos locales, cuenta entre 8 y 16 GB según el modelo.

¿Puedo correr varios agentes a la vez?

Sí. Cada agente puede tener su propio modelo, configuración y conjunto de skills.

openclaw agent create "agente-email" --model gpt-4o
openclaw agent create "agente-dev" --model claude-sonnet-4.5
¿Es seguro darle acceso a mi sistema?

Ejecuta comandos con tus permisos de usuario, así que trátalo como tratarías a un script con acceso a tu shell: listas blancas y negras de comandos, modo sandbox si tienes dudas, y nunca como root.

Recursos oficiales

Todo lo que he escrito sobre el proyecto, ordenado, está en la guía de OpenClaw.

Fuentes