Instalación: 5 minutos y listo OpenClaw
Esta lección es el punto de partida práctico de todo el tutorial y también la vía principal para instalar OpenClaw: un comando oficial de instalación + onboarding guiado, desde escribir el comando hasta recibir la primera respuesta de la IA en el navegador; la cifra oficial es de unos 5 minutos——siempre que ya tengas un inicio de sesión de Claude Code / Codex CLI o una clave API de algún modelo; el tiempo para solicitar una clave desde cero se cuenta aparte (el paso 3 indica dónde conseguirla).
Los métodos alternativos como la aplicación de escritorio, Docker o la instalación directa con npm se tratan por separado en la siguiente lección; si la instalación falla o algo no funciona, ve directamente a Qué hacer si la instalación falla para revisar y diagnosticar. Este tutorial se basa en v2026.10.9 (ya es una versión posterior a «OpenClaw 2.0»).
Qué podrás hacer al terminar
- Instalar OpenClaw con un solo comando en macOS, Linux y Windows
- Probar primero una experiencia completa con
npx openclaw@latestantes de decidir si instalar formalmente - Dejar que el onboarding reutilice automáticamente tu inicio de sesión de Claude Code / Codex o clave API existente, sin configuración manual
- Instalar el Gateway como servicio en segundo plano y usar
openclaw gateway statuspara confirmar que escucha en el puerto 18789 - Enviar el primer mensaje en Control UI y recibir la respuesta de la IA——completando todo el recorrido, de la instalación a la conversación
Tu situación actual
- Al buscar «instalación de OpenClaw» aparecen tutoriales de versión incierta; muchos usan comandos antiguos de la era Clawdbot / Moltbot que dan errores si los copias tal cual
- Quieres probar esta herramienta antes de decidir si instalarla, pero muchas herramientas exigen registrarse en un montón de cosas incluso para la prueba
- A duras penas logras ejecutarla, y al cerrar la terminal el proceso desaparece; al día siguiente quieres seguir usándola y tienes que averiguar de nuevo «si realmente estaba en marcha»
Cuándo usar este método
Cuando necesitas:
- Poner en marcha OpenClaw formalmente en tu propia computadora——todas las lecciones posteriores (conectar modelos, conectar canales, automatización) se basan en este paso
- Seguir la vía de instalación más rápida: funciona en cualquier entorno, instala Node automáticamente si falta y entra en la guía al terminar
Y no quieres:
- Tropezar con tutoriales antiguos de versión incierta
- Perder tiempo primero con rutas alternativas como la aplicación de escritorio, Docker o compilar desde el código fuente
- Quedarte perdido tras la instalación: si el Gateway está en marcha o no, y dónde enviar mensajes
🎒 Preparativos antes de empezar
- Haber leído Qué es OpenClaw y saber qué significan los términos Gateway, onboarding y Control UI
- (Se puede completar después)OpenClaw 2.0 novedades no es un requisito previo de esta lección——si quieres avanzar rápido puedes saltarlo y repasar el contexto de versiones más adelante
- Una computadora macOS / Linux / Windows y una terminal con acceso a internet
- Un «pase de acceso al modelo»: un inicio de sesión existente de Claude Code o Codex CLI, o una clave API de cualquier proveedor de modelos——si no lo tienes, no es un obstáculo; el paso 3 indica dónde conseguirla
Requisitos del sistema
| Elemento | Requisito | Descripción |
|---|---|---|
| Sistema operativo | macOS / Linux / Windows | Windows tiene tres vías: la aplicación Windows Hub, el instalador de PowerShell y WSL2 Gateway (esta página usa el instalador de PowerShell) |
| Node.js | 24.16.0+ (24.x) o 26.1.0+ | Se recomienda encarecidamente 24.22.1+ / 26.12.1+ (correcciones de seguridad); Node 26 es la versión recomendada |
| ¿No tienes Node? | No es necesario instalarlo de antemano | El instalador oficial lo instala automáticamente si falta: en macOS instala Node 26, en Linux instala Node 24 LTS |
Para los detalles de versión de Node y la verificación de compatibilidad, consulta la documentación oficial Node.js compatibility.
Idea central
Instalación de OpenClaw: ¿qué se instala exactamente? Tres cosas:
- CLI——
openclaw, el comando, tu punto de entrada a OpenClaw - Una configuración——lo que el onboarding escribe: «qué modelo usar, con qué credenciales»
- Un proceso Gateway residente——el plano de control local; las sesiones, las herramientas y las conexiones de canales son todas cosa suya; la Control UI, la CLI y la TUI son sus clientes
¿Por qué se puede tener funcionando en 5 minutos? Porque el onboarding detecta automáticamente tus inicios de sesión ya existentes en Claude Code / Codex CLI o tus API Keys, y tras validarlas con una llamada real al modelo (completion) las guarda directamente en la configuración; si ya tienes credenciales válidas, prácticamente no tienes que hacer nada durante la guía.
Hay más de un camino para empezar; esta página te guía por los dos primeros, y el tercero en la siguiente lección:
| Método | Para quién | En una frase |
|---|---|---|
| Instalador oficial (recomendado) | Quien quiera una instalación formal y uso a largo plazo | Detecta el sistema, instala Node automáticamente si falta y entra al onboarding al terminar |
npx openclaw@latest | Probarlo primero antes de decidir | Un solo comando levanta la experiencia completa, con el Gateway corriendo en la terminal actual |
| Instalación directa con npm / pnpm / Bun, aplicación de escritorio, Docker | Quien gestiona su propio Node, no quiere tocar la terminal o necesita un servidor | Ver métodos de instalación alternativos |
Una cosa más para recordar de antemano: recién instalado, el Gateway corre en primer plano en la terminal; Ctrl+C lo detiene y la configuración se conserva; si quieres que quede residente desde el arranque sin temer cerrar la terminal, instálalo como servicio en segundo plano en el paso 4.
Hazlo conmigo
Paso 1: confirma la versión de Node——el requisito previo de entorno para instalar OpenClaw
Por qué: OpenClaw es una aplicación Node.js; con un Node demasiado antiguo, cada paso posterior dará errores en cadena. Dedica 10 segundos a verificarlo y ahórrate una hora de depuración.
node --versionDeberías ver: la terminal imprime el número de versión. Solo es válido 24.x con v24.16.0 o superior, o 26.x con v26.1.0 o superior (se recomienda encarecidamente usar las versiones con correcciones de seguridad 24.22.1+ / 26.12.1+).
Compara con tres escenarios:
Imprime una v24 / v26 válida → pasa directamente al paso 2
Imprime v20 / v22 o algo más antiguo → fuera del rango soportado; actualiza primero (ver el aviso de errores comunes número 1 más abajo)
Muestra
command not found——no lo tienes instalado, no pasa nada: el instalador oficial instala Node automáticamente si falta (Node 26 en macOS, Node 24 LTS en Linux); puedes ir directo al paso 2node --versionimprime una versión 24.x ≥ 24.16.0 o una 26.x ≥ 26.1.0 (o confirmas que dejarás que el instalador lo instale automáticamente)
Paso 2: un solo comando completa la instalación de OpenClaw
Por qué: el instalador oficial es la vía principal más rápida——detecta el sistema operativo, instala Node si hace falta, instala OpenClaw y luego arranca automáticamente la guía de onboarding.
Método A (recomendado): instalador oficial
Usuarios de macOS / Linux (también este comando dentro de WSL2; la instalación en macOS y en Linux usan el mismo comando):
curl -fsSL https://openclaw.ai/install.sh | bashUsuarios de Windows (PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iexDeberías ver: el instalador se pone a trabajar——detecta el sistema → (si hace falta) instala Node → instala OpenClaw → entra automáticamente al asistente de onboarding, cuyo inicio incluye una línea con un aviso que remite a la guía oficial de seguridad.
💡 ¿Solo instalar, sin entrar a la guía?
Las instalaciones automatizadas en lote pueden saltarse el onboarding:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardTodos los parámetros del instalador están en la documentación oficial Installer internals.
⚠️ Redes de China continental
La documentación oficial no ofrece espejos nacionales ni soluciones de aceleración de descargas, y este artículo no especula con direcciones de espejo. Si la descarga del script de instalación o de las dependencias expira, revisa primero el entorno de red y reintenta; si los fallos persisten, ve a qué hacer si no se instala para comparar y diagnosticar.
Método B: npx openclaw@latest probar primero
¿No quieres instalar todavía? Un solo comando levanta el OpenClaw completo:
npx openclaw@latestLa experiencia es idéntica al método A: entras al onboarding como de costumbre y abres el web dashboard igualmente; el Gateway corre en esta terminal actual, y tras detenerlo con Ctrl+C la configuración se conserva igual. Si al terminar te gusta, pasa entonces al método A para una instalación formal.
- El asistente de onboarding aparece en la terminal (vale tanto para el método A como para el método B)
Paso 3: completa el onboarding——reutiliza las credenciales de modelo que ya tienes
Por qué: OpenClaw en sí no trae modelos. El onboarding configura de una vez «qué modelo usar, con qué credenciales»——solo con este paso configurado habrá después respuestas de la IA.
Cuando arranque el asistente, elige una opción:
- Quick start (recomendado): cuando ya tienes un inicio de sesión en Claude Code / Codex CLI o la API Key de algún provider——OpenClaw lo detecta automáticamente, valida su disponibilidad con una completion real, guarda la configuración y abre el web dashboard. La documentación oficial lo deja claro: si ya tienes acceso de IA funcional, aparte de la línea de aviso de seguridad del inicio, la guía no preguntará nada más.
- Custom setup: recorre todas las opciones de la guía; cuando ninguna de las vías de detección automática funciona, el asistente abre la configuración manual de provider.
Deberías ver: tras elegir Quick start, todo en verde——detecta credenciales → valida → guarda la configuración → el navegador abre el dashboard, mientras el Gateway arranca en primer plano en la terminal actual.
💡 ¿Quieres deshacer y volver a configurar?
openclaw configure cambia los ajustes cuando quieras; openclaw onboard --classic abre el asistente clásico paso a paso para repetir la guía desde el principio.
¿No tienes ni una sola «credencial de acceso»? Dos salidas:
Consigue la Key de un modelo de proveedores chinos——DeepSeek, Tongyi Qianwen, Zhipu GLM, Kimi, MiniMax, Doubao/Volcano Engine, Hunyuan y Qianfan tienen todos plugins oficiales de provider; tras el resumen de conexión de modelos, las secciones 1.6–1.12 explican la configuración de cada uno
¿Presupuesto limitado? modelos locales te enseña a correr modelos en tu propia máquina con Ollama y vLLM
onboarding completado: el Gateway ya está iniciado en la terminal y el dashboard ya está abierto en el navegador (o ya has entrado en la página de configuración manual)
Paso 4: instalar el Gateway como servicio en segundo plano
Por qué: después del Quick start, el Gateway corre en primer plano en la terminal; si cierras la terminal, se detiene. Solo instalándolo como servicio del sistema puede quedarse de forma permanente en segundo plano, y solo así tendrás la base para conectar canales, tareas programadas y acceso remoto desde el móvil.
Primero detén el Gateway en primer plano con Ctrl+C (la configuración se conserva, no hay que repetir el onboarding), y luego:
openclaw gateway installDeberías ver: el mensaje de que la instalación del servicio se completó. En estos tres sistemas se materializa respectivamente como: LaunchAgent en macOS, unidad de usuario de systemd en Linux / WSL2, y tarea programada en Windows nativo (si se rechaza la creación, se recurre a un elemento de inicio Startup a nivel de usuario).
openclaw gateway installse ejecuta con éxito, sin errores
Paso 5: verificar que el Gateway está en ejecución
Por qué: un servicio en segundo plano no se ve ni se toca; con un solo comando confirmas que está vivo antes de seguir.
openclaw gateway statusDeberías ver: el Gateway está en ejecución, escuchando en el puerto predeterminado 18789.
De paso, haz dos comprobaciones rápidas (opcional):
openclaw --version # 确认 CLI 可用
openclaw doctor # 检查配置问题Deberías ver: --version imprime el número de versión (la referencia de este tutorial es la v2026.10.9); doctor da el resultado de la comprobación de configuración.
openclaw gateway statusmuestra que el Gateway escucha en el puerto 18789
Paso 6: abrir la Control UI y enviar el primer mensaje
Por qué: la Control UI es la consola en el navegador, y la primera conversación se hace aquí; al recibir la respuesta de la IA, el objetivo de «en 5 minutos en marcha» se considera realmente cumplido.
openclaw dashboardDeberías ver: el navegador abre la Control UI (dirección predeterminada http://<host>:18789/). Escribe un mensaje en el cuadro de chat, por ejemplo «Hola, preséntate»—unos segundos después recibirás la respuesta de la IA.
Llegados aquí, «en 5 minutos en marcha» queda completado: el Gateway reside de forma permanente, las credenciales están configuradas y la primera respuesta está en tus manos. El uso completo de la Control UI se explica en Control UI: la consola en el navegador.
💡 Por defecto el Gateway solo escucha en la máquina local
Una vez instalado, el Gateway escucha por defecto en la dirección de loopback de la máquina local, puerto 18789, y las máquinas externas no pueden acceder: es un valor predeterminado de seguridad intencionado. Para el acceso remoto es obligatorio configurar autenticación; las reglas se explican en Endurecimiento de seguridad (1).
- Has enviado un mensaje en la Control UI y has recibido la respuesta de la IA
Punto de control ✅
openclaw --versionpuede imprimir el número de versión (la referencia de este tutorial es la v2026.10.9)- El onboarding reutilizó credenciales existentes, o configuraste manualmente un provider
openclaw gateway statusmuestra que el Gateway está en ejecución, escuchando en 18789openclaw dashboardabre la Control UI y el mensaje enviado recibió una respuesta de la IA- El Gateway ya está instalado como servicio en segundo plano; cerrar la terminal ya no lo afecta
Advertencias sobre errores comunes
❌ Versión de Node demasiado antigua (ni la v20 ni la v22 sirven)
Causa: OpenClaw requiere Node 24.16.0+ (24.x) o 26.1.0+, se recomienda Node 26 y se aconseja encarecidamente 24.22.1+ / 26.12.1+. Las v20 y v22 no están dentro del rango soportado.
node --version
# v20.x.x、v22.x.x → 太旧
# v24.16.0+(24.x)或 v26.1.0+ → 合格Solución correcta: primero actualiza y luego instala, o directamente ejecuta el instalador oficial del paso 2: si falta Node, lo instala automáticamente (Node 26 en macOS, Node 24 LTS en Linux). Los detalles de compatibilidad de versiones están en ¿Qué hacer si no se instala?.
❌ openclaw: command not found
Causa: la documentación oficial de instalación dice literalmente «casi siempre es un problema de PATH»: el directorio bin global de npm no está en la PATH de tu shell.
Autochequeo en tres líneas:
node -v # Node 装了吗
npm prefix -g # 全局包装在哪
echo "$PATH" # 全局 bin 目录在 PATH 里吗Solución correcta: sigue los pasos de corrección de PATH de ¿Qué hacer si no se instala?; si modificaste el PATH, recuerda reabrir la terminal para que surta efecto.
❌ Cerrar la terminal y pensar que OpenClaw «se rompió»
Causa: después del Quick start, el Gateway corre en primer plano en la terminal; Ctrl+C lo detiene, y cerrar la terminal hace lo mismo; pero toda la configuración se conserva, no falta nada de lo que instalaste.
Solución correcta: para uso a largo plazo, ejecuta el openclaw gateway install del paso 4 para instalarlo como servicio en segundo plano; para uso temporal, basta con Ctrl+C, sin repetir el onboarding.
❌ Tomar los «5 minutos» como una promesa incondicional
Causa: los «aproximadamente 5 minutos» oficiales tienen una premisa: ya tienes a mano un inicio de sesión de Claude Code / Codex CLI o una API Key de un provider. El tiempo de registrar una cuenta desde cero, solicitar la Key y elegir el modelo no cuenta.
Solución correcta: primero ve a Resumen de conexión de modelos para elegir uno y tener la Key lista, y luego vuelve a ejecutar la instalación; en el onboarding, elegir Custom setup permite configurar manualmente.
Técnicas avanzadas (opcional)
¿Atascado? Autochequeo con un solo comando. openclaw triage: comprobación de solo lectura → genera un aviso de diagnóstico anonimizado (secrets, tokens, contenido original del chat y logs originales quedan fuera) → se lo entrega al agente de codificación detectado en tu máquina (Claude Code, Codex CLI o el agente integrado de OpenClaw) para que continúe la reparación con el diagnóstico.
Hasta que elijas un agente, ningún dato sale de tu máquina; si prefieres hacerlo tú mismo, elige "just print the commands". Para leer directamente el resultado del diagnóstico, usa openclaw doctor.
Personalizar la ubicación de los datos. Si quieres apuntar el directorio de OpenClaw a otro lugar, tres variables de entorno:
OPENCLAW_HOME—directorio principal para la resolución de rutas internasOPENCLAW_STATE_DIR—sobrescribe el directorio de estadoOPENCLAW_CONFIG_PATH—sobrescribe la ruta del archivo de configuración
Tres caminos en Windows. Para usuarios de escritorio, lo que más recomienda oficialmente es la aplicación Windows Hub (con interfaz de instalación, estado en la bandeja y chat); el instalador PowerShell de esta página es la vía CLI, y WSL2 sirve para poner el Gateway dentro del subsistema Linux. La comparación detallada de los tres está en Formas alternativas de instalación.
Instalación directa con npm en una frase. Los desarrolladores que gestionan Node por su cuenta (Node 24.22.1+ / 26.12.1+) pueden saltarse el script de instalación:
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemonCon npm 12 o 11.16+ cópialo tal cual; con npm 11.15 o anterior, quita --allow-scripts=openclaw. La comparación completa de pnpm / Bun / Docker / compilación desde código fuente está en Formas alternativas de instalación; si quieres ejecutar 7×24 en un servidor, consulta Despliegue en servidor.
Resumen de esta lección
✅ OpenClaw: la ruta principal de instalación funciona: un solo curl en macOS / Linux, un solo comando de PowerShell en Windows, el onboarding reutiliza automáticamente las credenciales existentes, el Gateway se instala como servicio en segundo plano y recibes la primera respuesta en la Control UI.
✅ Ya sabes elegir entre tres formas de empezar: instalador oficial (recomendado, instala Node automáticamente si falta), npx openclaw@latest (probar antes de decidir) e instalación directa con npm (para quienes gestionan su propio Node; los detalles en la próxima lección).
✅ Los límites de los «5 minutos» quedan claros: se asume que ya tienes sesión de Claude Code / Codex o una API Key; el tiempo para obtener una Key desde cero se cuenta aparte.
✅ Conoces el estado por defecto tras la instalación: el Gateway escucha en 18789 y, por defecto, solo acepta conexiones locales; un Gateway en primer plano se detiene al cerrar la terminal, pero instalado como servicio queda residente.
| Comando | Función | Notas |
|---|---|---|
curl -fsSL https://openclaw.ai/install.sh | bash | Instalación en macOS / Linux / WSL2 | Instalador oficial, instala Node automáticamente si falta |
iwr -useb https://openclaw.ai/install.ps1 | iex | Instalación en Windows | Instalador oficial en versión PowerShell |
npx openclaw@latest | Probar con un solo comando | Ejecuta el flujo completo sin instalación formal |
openclaw onboard --install-daemon | Onboarding tras instalación directa | Se usa tras instalar directamente con npm / pnpm / Bun |
openclaw gateway install | Instalar como servicio en segundo plano | LaunchAgent en macOS / systemd en Linux / Tarea programada en Windows |
openclaw gateway status | Confirmar que el Gateway está activo | Deberías verlo escuchando en 18789 |
openclaw dashboard | Abrir la Control UI | Tu primera conversación ocurre aquí |
openclaw triage | Diagnóstico con un clic si te atascas | Chequeo de solo lectura + diagnóstico con datos anonimizados |
La lista completa de la guía rápida de comandos está en Guía rápida de comandos y configuración de la CLI.
Avance de la próxima lección
La ruta principal ya funciona, pero no todos pueden seguirla: los ordenadores corporativos no permiten ejecutar scripts, algunos prefieren una aplicación de escritorio y en los servidores lo que se necesita es Docker. La próxima lección, Métodos de instalación alternativos: aplicación de escritorio, Docker y npm, allana los demás caminos.
Aprenderás:
- Cómo instalar Windows Hub y la aplicación de barra de menús de macOS, sin tocar la terminal en ningún momento
- El flujo completo del despliegue en contenedores con Docker / Podman
- Los parámetros de la instalación directa con npm / pnpm / Bun y los pequeños escollos de cada una
- Una tabla comparativa: qué método de instalación elegir según el escenario