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 (Windows, un servidor 24/7, un contenedor, una Raspberry Pi).
Si vas a instalar OpenClaw en Windows, salta directo a su guía: el script de arriba asume un shell tipo Unix, y en Windows hay tres caminos oficiales, dos de ellos nativos y sin WSL2. Están todos en instalar OpenClaw en Windows 10 y 11.
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 24.16+ o 26.1+, macOS, Linux o Windows 10/11, 1 GB de RAM como mínimo y una API key de un proveedor de IA, salvo que vayas a usar modelos locales.
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. El detalle (qué versiones de Node quedaron fuera y cuánta RAM conviene) está en requisitos de OpenClaw y errores comunes.
Instalar OpenClaw con el script oficial
curl -fsSL https://openclaw.ai/install.sh | bashEl script detecta tu sistema, instala Node.js si no está, instala OpenClaw globalmente y lanza el onboarding (openclaw onboard). Para que el agente siga vivo en segundo plano, registra el servicio con openclaw onboard --install-daemon o openclaw gateway install.
El onboarding empieza por el acceso a IA que ya tienes: una sesión de ChatGPT, Codex o Claude CLI, una API key o modelos locales de Ollama o LM Studio. Verifica la conexión que eliges con una respuesta real y abre el dashboard web. Los canales, las skills y el puerto del gateway (18789 por defecto) se configuran después, hablando con tu Claw o con openclaw configure.
Instalar OpenClaw con npm
Si prefieres control sobre cada paso, o ya tienes tu Node.js como lo quieres:
# npm 12 o npm 11.16+
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemonCon npm 11.15 o anterior, el mismo comando va sin --allow-scripts=openclaw.
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 y 11 | Tres vías oficiales, dos 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 statusEl 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 una allowlist de comandos y pide aprobación para el resto, y nunca lo corras como root. Con tools.exec.mode en "ask", los comandos de la allowlist corren directo y los demás esperan tu aprobación:
{
"tools": {
"exec": {
"mode": "ask"
}
}
}La allowlist se edita desde la CLI:
openclaw approvals allowlist add "/usr/bin/git"
openclaw approvals getActualizar OpenClaw
openclaw updateDetecta cómo lo instalaste (npm, pnpm, Bun o git), comprueba la versión nueva mientras el gateway viejo sigue sirviendo, y después la activa y la verifica. Si lo instalaste con Docker Compose, la actualización va por docker compose pull y está explicada en su guía.
Si vienes de una versión anterior a OpenClaw 2.0 (v2026.8.1), la actualización tiene tres breaking changes y varios comportamientos por defecto que cambian solos. Están en qué cambia en OpenClaw 2.0 y cómo actualizar.
Si algo falla
El primer comando ante cualquier problema es el diagnóstico integrado:
openclaw doctorRevisa 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 costo, pero necesitas hardware que los mueva.
¿Necesito WSL2 para instalar OpenClaw en Windows?
No, hay dos vías nativas además de WSL2. Cuál te conviene depende de si quieres systemd, y la comparación de las tres está en instalar OpenClaw en 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?
El mínimo es 1 GB; cuánto conviene según el uso está en requisitos de OpenClaw. 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, workspace y conjunto de skills.
openclaw agents add agente-email --workspace ~/.openclaw/workspace-email --model openai/gpt-5.5
openclaw agents add agente-dev --workspace ~/.openclaw/workspace-dev --model anthropic/claude-sonnet-4-6¿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: una allowlist de comandos con aprobación para el resto, modo sandbox si tienes dudas, y nunca como root.
Recursos oficiales
- Documentación: docs.openclaw.ai
- Repositorio: github.com/openclaw/openclaw
- Paquete npm: npmjs.com/package/openclaw
- Comunidad: discord.gg/openclaw
Todo lo que he escrito sobre el proyecto, ordenado, está en la guía de OpenClaw.
Fuentes
- Installer Internals - OpenClaw Official Docs
- Node.js compatibility - OpenClaw Official Docs
- Updating - OpenClaw Official Docs
- Docker - OpenClaw Official Docs
- OpenClaw GitHub Repository
- openclaw - npm
- No Mac Mini, no worries: running OpenClaw on a Raspberry Pi | ajfisher
- Running OpenClaw in Docker | Simon Willison's TILs
- OpenClaw - Wikipedia
¿Tienes un proyecto en mente?
Trabajo con Laravel, WordPress, SEO técnico y servidores MCP. El primer paso es una llamada de descubrimiento, sin costo ni compromiso, donde me cuentas qué necesitas y te digo con honestidad si puedo ayudarte.