Métodos de instalación alternativos: aplicación de escritorio, Docker y npm
La lección anterior completó la ruta principal con el instalador oficial; pero la descarga e instalación de OpenClaw no se limita a ese camino: el ordenador de la empresa no permite ejecutar scripts, quieres una aplicación de escritorio residente en la bandeja, necesitas contenedores en el servidor, o tú mismo gestionas Node y prefieres no delegar en el instalador. Esta lección explica de una vez las cuatro rutas alternativas (aplicación de escritorio, Docker, instalación directa con npm / pnpm / Bun y compilación desde el código fuente); en 8 minutos elige una según tu escenario. Esta página se basa en v2026.10.9.
Qué podrás hacer al terminar
- Descargar e instalar Windows Hub (instaladores firmados x64 / ARM64) o la aplicación de barra de menús de macOS: la forma de descargar OpenClaw sin tocar la terminal en ningún momento
- Ejecutar un Gateway en contenedor con Docker: el script de setup completa automáticamente el onboarding, y el Control UI se abre en el navegador en el puerto 18789
- Instalar directamente OpenClaw con los tres gestores de paquetes npm / pnpm / Bun, y recordar el parámetro obligatorio de cada uno
- Instalar compilando desde el código fuente y enlazar el CLI
openclawa tu propio checkout - Elegir tu ruta según el escenario con una tabla comparativa (escritorio / Docker / instalación directa / código fuente)
Tu situación actual
- El ordenador de la empresa no permite ejecutar scripts como
curl | bash, y quieres un instalador serio que se instale con doble clic - Soy usuario de escritorio Windows / macOS, solo quiero una App en la bandeja o en la barra de menús, sin abrir la terminal
- Necesito ejecutar 7×24 en contenedores en el servidor, o yo mismo gestiono Node, y el «autoinstalar Node» del instalador estorba
Cuándo usar este método
Cuando necesitas:
- Una forma de descargar e instalar OpenClaw con interfaz gráfica (aplicación de escritorio)
- Un entorno de Gateway aislado, desechable y que no contamine tu máquina (Docker)
- Instalar con tu propio gestor de paquetes (npm / pnpm / Bun), o ejecutar directamente la rama main más reciente (compilación desde el código fuente)
Y no quieres:
- Volver a la lección anterior y su ruta principal del instalador oficial con
curl | bash - Instalar un runtime de Node en tu sistema (tanto la aplicación de escritorio como Docker incluyen su propio runtime)
🎒 Preparativos antes de empezar
- Haber completado Instalación: en marcha en 5 minutos con OpenClaw: esta página es su complemento de rutas alternativas; si la ruta principal te funciona, no hace falta cambiar
- Tener listo el entorno según la ruta que vayas a seguir (ver tabla abajo)
- Tener a mano un «pase de modelo»: tanto el primer arranque de la App de escritorio, como el setup de Docker, como
openclaw onboardte guiarán para configurar credenciales de modelo (inicio de sesión con Claude Code / Codex CLI o API Key; consulta Resumen de conexión de modelos)
Requisitos de entorno de cada ruta
| Ruta | Debes tener primero |
|---|---|
| Aplicación de escritorio | Basta con poder descargar el instalador: Windows 10 20H2+ / Windows 11 (Hub), macOS 26.2 (Tahoe)+ (App de barra de menús) |
| Docker | Docker Desktop o Docker Engine + Docker Compose v2; para compilar la imagen localmente, al menos 6 GB de memoria |
| Instalación directa con npm / pnpm / Bun | Node 24.16.0+ (24.x) o 26.1.0+ (se recomienda 24.22.1+ / 26.12.1+); la ruta con Bun requiere Bun 1.4.4+ |
| Compilación desde el código fuente | Node + Corepack (o pnpm 12 instalado por tu cuenta) + git |
⚠️ Red de China continental
La documentación oficial no ofrece un espejo nacional ni una solución de descarga acelerada, y este artículo no especula sobre direcciones de espejo. Si al descargar el instalador de escritorio desde GitHub Releases o al extraer la imagen desde GHCR se agota el tiempo de espera, primero revisa el entorno de red y reintenta; si sigue fallando, consulta qué hacer si no se instala para una verificación comparativa.
Idea central
Todos los métodos de instalación instalan lo mismo: un proceso Gateway + CLI openclaw + una configuración. La diferencia entre las cuatro rutas alternativas está solo en «dónde corre el Gateway y quién gestiona el runtime»:
| Ruta | Dónde corre el Gateway | Runtime | Para quién |
|---|---|---|---|
| Instalador oficial (ruta principal de la lección anterior) | Servicio en segundo plano en la máquina local | Si falta Node, el instalador lo añade automáticamente | Quien quiera ponerlo en marcha lo más rápido posible |
| Aplicación de escritorio | Configura un Gateway local en el primer arranque de la App, o se conecta a un Gateway remoto ya existente | La App gestiona su propio runtime, no depende del Node del sistema | Usuarios de escritorio que no quieren tocar la terminal |
| Docker / Podman | Dentro del contenedor | Incluido en la imagen | Entorno aislado, servidores, sin instalación local |
| Instalación directa con npm / pnpm / Bun | Máquina local (--install-daemon instalado como servicio) | Lo gestionas tú | Desarrolladores, instalación masiva en CI |
| Compilación desde el código fuente | Máquina local | Lo gestionas tú + pnpm | Colaboradores, quienes necesitan ejecutar el main más reciente |
Las cuatro rutas son independientes entre sí; elige una según tu escenario; los pasos siguientes tienen numeración continua para facilitar las referencias cruzadas.
Hazlo conmigo
Paso 1: descargar la versión de escritorio de OpenClaw——Windows Hub y la aplicación de barra de menús de macOS
Por qué: la aplicación de escritorio es la vía de descarga de OpenClaw que la documentación oficial ofrece a los usuarios que «no tocan la terminal»——descargar el instalador, guía mediante interfaz gráfica. Windows Hub y la App de barra de menús de macOS, estas dos aplicaciones de escritorio nativas, pueden configurar un Gateway local durante el ajuste inicial, o conectarse directamente a un Gateway remoto ya existente.
Usuarios de Windows: Windows Hub (recomendado oficialmente)
En Windows, lo más recomendado oficialmente es Windows Hub——una aplicación compañera nativa en WinUI, compatible con Windows 10 20H2+ y Windows 11, instalación sin permisos de administrador, con instaladores firmados tanto para x64 como para ARM64:
- x64: OpenClawCompanion-Setup-x64.exe
- ARM64: OpenClawCompanion-Setup-arm64.exe
- Todas las versiones: página de releases de Windows Hub
Tras descargar e instalar, inicia OpenClaw Companion desde el menú de inicio o la bandeja del sistema (el instalador también crea accesos directos para Gateway Setup, Chat, Settings, comprobar actualizaciones y desinstalar). Si en el primer arranque no encuentra un Gateway disponible, entra automáticamente en la configuración: el camino más rápido es Set up locally——crea una distribución OpenClawGateway WSL gestionada por la propia aplicación, instala el Gateway dentro y completa el emparejamiento, sin tocar tu distribución de Ubuntu ya existente. Si ya tienes un Gateway, elige Advanced setup, que permite conectarte a un Gateway local / en WSL / remoto (URL + token) o a través de un túnel SSH.
Deberías ver: al terminar la configuración, el icono de la bandeja se pone verde; al abrir Command Center desde la bandeja, verás que la conexión, el emparejamiento, el estado de los nodos y la salud de los canales están todos correctos.
💡 ¿El enlace directo da 404?
El ritmo de publicación de Windows Hub es independiente del CLI y del Gateway de OpenClaw. Cuando los enlaces directos de arriba dejen de funcionar, ve a la página de releases de Windows Hub y abre la última versión estable. Para más detalles, consulta la documentación oficial de la plataforma Windows.
Alternativa en Windows: la aplicación de escritorio Tauri multiplataforma——el instalador OpenClaw-<version>-windows-x86_64.exe se publica junto con OpenClaw en cada versión oficial (GitHub Releases); puede usar el Bun integrado para configurar un Gateway local de Windows, o conectarse a un Gateway remoto.
Usuarios de macOS: aplicación de barra de menús
La versión de escritorio de macOS es la aplicación compañera de barra de menús: descarga OpenClaw-<version>.dmg (opción preferida) o .zip desde OpenClaw GitHub Releases, instala e inicia OpenClaw.app.
Requisitos del sistema: macOS 26.2 (Tahoe) o superior.
Deberías ver: en el primer arranque tras una instalación limpia aparece una ventana de progreso——la App prepara el runtime incluido, inicia el Gateway en «This Mac» y abre el diálogo de onboarding del dashboard; al estar lista, la ventana se cierra automáticamente. Después, el icono de OpenClaw permanece en la barra de menús, y Quick Chat se invoca por defecto con ⌥Space.
💡 ¿El último Release no trae paquete de macOS?
Algunos Releases incluyen solo el CLI o los archivos de Windows. Indicación oficial: usa la versión más reciente que incluya paquete de macOS——la página oficial de la aplicación de macOS tiene actualmente fijados los tres DMG de 2026.10.3 (Apple Silicon / Intel / Universal); para más detalles, consulta la documentación oficial de la app de macOS.
- App de escritorio iniciada: el icono de la bandeja de Windows se pone verde, o aparece el icono de OpenClaw en la barra de menús de macOS
Paso 2: ejecutar un Gateway en contenedor con Docker
Por qué: la posición oficial sobre la ruta Docker de OpenClaw es «opcional»——adecuada cuando se quiere un entorno de Gateway aislado y desechable, o un host sin instalación local. Para el uso diario en tu propia máquina de desarrollo, la recomendación oficial es seguir el proceso de instalación normal (lección anterior).
Primero, prepara los requisitos previos:
- Docker Desktop (o Docker Engine) + Docker Compose v2
- Al menos 6 GB de memoria para construir la imagen localmente desde el código fuente——con la imagen preconstruida oficial puedes evitar este requisito
- Espacio en disco suficiente para la imagen y los registros
Luego, cuatro comandos (el script de setup debe ejecutarse desde el directorio raíz del repositorio, clona primero):
git clone https://github.com/openclaw/openclaw.git
cd openclaw
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.shOPENCLAW_IMAGE apunta a la imagen oficial precompilada (GitHub Container Registry es el canal de publicación principal, página del paquete); si no se establece, el script compila openclaw:local localmente. El mismo Release también publica la imagen openclaw/openclaw en Docker Hub. El aviso oficial es claro: usa solo estas dos direcciones oficiales y evita los espejos de terceros, ya que su ritmo de publicación y sus políticas de retención no están sincronizados. Para fijar la versión, usa una etiqueta de versión concreta (por ejemplo 2026.9.3); las variantes incluyen slim, -browser (con Chromium integrado), etc., y la imagen predeterminada incluye los plugins codex y diagnostics-otel.
Deberías ver: setup completa automáticamente el onboarding—pide la API Key del proveedor → genera el token del Gateway y lo escribe en .env → inicia el Gateway mediante Docker Compose.
Abre la Control UI: accede con el navegador a http://127.0.0.1:18789/ y pega en Settings el token que está en .env. Si olvidas la dirección, vuelve a obtenerla:
docker compose run --rm openclaw-cli dashboard --no-openComprobación de salud del contenedor (sin autenticación; el HEALTHCHECK integrado en la imagen consulta exactamente esto):
curl -fsS http://127.0.0.1:18789/healthzDeberías ver: healthz responde con normalidad; /startupz (comprobación de arranque) y /readyz (disponibilidad profunda) están en el mismo puerto.
curl http://127.0.0.1:18789/healthzresponde con normalidad, y la Control UI permite iniciar sesión con el token de.env
💡 ¿Quieres ejecutar 7×24 en un servidor?
Este paso solo te guía para poner en marcha el Gateway en contenedor. La elección de VPS, la operación y el mantenimiento con compose, y las reglas de seguridad para la exposición a la red pública (incluida la cadena de firewall DOCKER-USER de Docker) se tratan en Despliegue en servidor: ejecución de 7×24 en Docker/VPS y Endurecimiento de seguridad (parte 1).
Paso 3: instalación directa con npm / pnpm / Bun
Por qué: los desarrolladores que gestionan Node por su cuenta no necesitan un instalador que lo haga por ellos—OpenClaw con npm (pnpm / Bun funcionan igual) se instala con un solo comando, y luego se ejecuta el onboarding para instalar el Gateway como servicio en segundo plano. También es la vía estándar en CI o en máquinas en lote.
Requisito previo: Node 24.16.0+ (24.x) o 26.1.0+ (la recomendación oficial es encarecidamente 24.22.1+ / 26.12.1+). Verifica primero con node --version.
Vía A: npm (npm 12 o 11.16+)
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemonnpm 11.15 y anteriores: quita --allow-scripts=openclaw (esa versión no tiene ni esa política ni esa opción).
Por qué incluir --allow-scripts: npm 12 bloquea por defecto los scripts del ciclo de vida de paquetes no aprobados; sin añadirlo, los preinstall / postinstall de OpenClaw darán el error blocked because they are not covered by allowScripts. npm 11.16 acepta esta opción pero solo advierte y ejecuta igualmente.
Vía B: pnpm
pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemonpnpm exige aprobación explícita para los paquetes con scripts de build, y approve-builds -g no admite instalación global—por eso --allow-build=openclaw se escribe directamente en el comando de instalación.
Vía C: Bun
bun add -g --trust openclaw@latest
bun run --bun openclaw onboard --install-daemon --daemon-runtime bun--trust permite los scripts del ciclo de vida del paquete OpenClaw; bun run --bun fuerza el runtime de Bun y --daemon-runtime bun instala el Gateway gestionado bajo Bun. Se necesita Bun 1.4.4 o superior para ejecutar la CLI, el agente local y el Gateway de OpenClaw; Node sigue siendo el runtime principal—el ejecutable independiente openclaw mantiene el shebang de Node.
Deberías ver: el resultado de las tres vías es el mismo—el comando openclaw está disponible, el onboarding se desarrolla con normalidad y el Gateway queda instalado como servicio en segundo plano.
- En la terminal
openclaw --versionimprime el número de versión
💡 Instalación manual con npm y la política de «frescura»
El instalador administrado oficialmente elimina para el paquete OpenClaw filtros de frescura de npm como min-release-age; cuando haces npm install -g manualmente, tus propias políticas de npm se aplican con normalidad. Si una política bloquea la instalación, revisa primero la configuración de npm.
Paso 4: instalación de OpenClaw compilando desde el código fuente
Por qué: esta vía es para contribuidores, quien quiera ejecutar el main más reciente o quien necesite modificar el código fuente—se clona desde GitHub, se compila con pnpm y se enlaza la CLI a este checkout.
git clone https://github.com/openclaw/openclaw.git
cd openclaw
corepack enable
pnpm install && pnpm build && pnpm ui:build
pnpm add --global "openclaw@link:$PWD"
openclaw onboard --install-daemonTres detalles:
pnpm add --global "openclaw@link:$PWD"enlaza la CLI al checkout actual sin modificar los archivos del paquete; si pnpm avisa de que el directorio bin global no está en el PATH, ejecutapnpm setup, reabre la terminal y vuelve a intentarlo- Corepack selecciona según
package.jsonla versión exacta de pnpm (actualmente pnpm 12) - En un checkout de servidor que solo ejecuta el Gateway se puede usar
pnpm build:runtime(no genera declaraciones TypeScript); si no quieres instalar globalmente, ejecuta directamentepnpm openclaw ...dentro del repositorio
Deberías ver: la compilación termina sin errores y openclaw apunta a tu copia local del código fuente.
pnpm buildypnpm ui:buildterminan ambos sin errores
Paso 5: verificar la instalación—tres comandos para confirmar que el Gateway está vivo
Por qué: sin importar la vía elegida, tras instalar hay que confirmarlo con el mismo conjunto de comandos—la CLI existe, la configuración no tiene fallos y el Gateway está en ejecución.
openclaw --version # CLI 可用
openclaw doctor # 检查配置问题
openclaw gateway status # Gateway 正在运行Deberías ver: --version imprime el número de versión (la referencia de este tutorial es v2026.10.9); doctor entrega el resultado del chequeo; gateway status muestra que el Gateway está en ejecución, escuchando en 18789.
Operaciones equivalentes en la vía Docker (el Gateway está en el contenedor, el host no lo tiene):
docker compose run --rm openclaw-cli dashboard --no-open # 重新拿到 Control UI 地址
curl -fsS http://127.0.0.1:18789/healthz # 容器健康检查- Los tres comandos de verificación pasan (en la vía Docker se usa
healthz+ dashboard)
Punto de control ✅
- Vía de escritorio: el icono de la bandeja de Windows Hub se pone verde, o la App de la barra de menús de macOS abrió el onboarding del dashboard
- Vía Docker:
http://127.0.0.1:18789/healthzresponde con normalidad, y la Control UI permite iniciar sesión con el token de.env - Vía npm / pnpm / Bun:
openclaw --versionproduce salida y el onboarding se completa - Vía del código fuente:
pnpm build && pnpm ui:buildtermina sin errores yopenclawqueda enlazado al checkout local - Puedo decir, mirando la tabla de «idea central», qué vía elegir para mi caso
Avisos de errores comunes
❌ La instalación directa con npm 12 da el error blocked because they are not covered by allowScripts
Causa: npm 12 bloquea por defecto los scripts del ciclo de vida de paquetes no aprobados, y los preinstall / postinstall de OpenClaw quedan bloqueados.
# ❌ npm 12 不带参数
npm install -g openclaw@latest
# → blocked because they are not covered by allowScripts
# ✅ 带上允许脚本的参数
npm install -g openclaw@latest --allow-scripts=openclawRecuerda bien las diferencias entre versiones: npm 11.16 acepta esa opción pero solo advierte y ejecuta igualmente; npm 11.15 y anteriores no tienen ni esta política ni esta opción, así que no la incluyas en el comando. Además, el npm approve-scripts openclaw recomendado por npm 11.16 no sirve para instalaciones globales — dará el error ENOMATCH No installed packages match: openclaw.
❌ El sistema macOS no es lo bastante reciente, no se puede instalar la App de la barra de menús
Causa: OpenClaw.app exige macOS 26.2 (Tahoe) o superior, y este umbral estricto no baja porque el CLI funcione — los binarios macOS oficiales de Node 24 / 26 soportan macOS 13.5+, pero «el CLI funciona» no equivale a «la App nativa es compatible».
Solución correcta: en Macs antiguas sigue la ruta de instalación por CLI de la lección anterior (los binarios oficiales de Node soportan macOS 13.5+).
❌ Construir la imagen Docker localmente: memoria insuficiente o fallo de construcción
Causa: construir localmente la imagen del Gateway desde el código fuente requiere al menos 6 GB de memoria.
Solución correcta: usa la imagen oficial preconstruida — export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest" y luego ejecuta el setup; al mismo tiempo, usa solo ghcr.io/openclaw/openclaw o el openclaw/openclaw de Docker Hub, evitando imágenes de terceros.
❌ Tras instalar openclaw: command not found globalmente con pnpm
Causa: el directorio bin global de pnpm no está en el PATH.
Solución correcta: ejecuta pnpm setup, vuelve a abrir la terminal y prueba de nuevo (palabra por palabra de la sección de instalación desde el código fuente oficial). Para el problema análogo con instalación global de npm (también mayormente el PATH), consulta qué hacer si no se instala.
Trucos avanzados (opcional)
Instalador de prefijo local: no toca el Node del sistema. Si quieres recoger OpenClaw junto con Node bajo el prefijo local ~/.openclaw, sin depender del Node a nivel de sistema:
curl -fsSL https://openclaw.ai/install-cli.sh | bashPor defecto instala vía npm, y también admite la instalación desde un git checkout bajo el mismo prefijo; tras instalar, usa openclaw update --channel dev / --channel stable para alternar entre instalación por paquete e instalación por git.
Instalación solo con Bun (fork oficial fijado). En macOS y Linux con glibc (arm64 / x64) puedes hacer la instalación completa sin recurrir a Node:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --runtime bunDescarga el fork OpenClaw de Bun fijado por esa Release y lo verifica; si se omite --runtime, el valor por defecto sigue siendo Node. En macOS instala Homebrew SQLite cuando hace falta (OpenClaw sobre Bun rechaza el SQLite del sistema de Apple). Para más detalles, consulta la documentación oficial de Bun.
Ejecutar la rama main más reciente (sin compilar a mano). Si no quieres compilar todo el código fuente pero sí seguir la rama main:
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version mainPodman / Nix / plataformas en la nube. ¿No quieres usar Docker? Oficialmente existe también la ruta Podman rootless (./scripts/podman/setup.sh, con el CLI del host como plano de control); Nix usa instalación declarativa con flake; Ansible para despliegues masivos. El despliegue de 7×24 en plataformas en la nube (Cloudflare, Render, Fly, Railway, etc.) y en VPS se trata en Despliegue en servidor.
Resumen de la lección
✅ Quedaron expuestas todas las rutas alternativas de descarga de OpenClaw: versión de escritorio (Windows Hub / barra de menús de macOS / alternativa Tauri para Windows), contenedor Docker, instalación directa con npm / pnpm / Bun, compilación desde el código fuente — las cuatro rutas instalan el mismo Gateway + CLI + configuración; elige una según el escenario.
✅ Ya sabes elegir la versión de escritorio: en Windows, la recomendación oficial es Windows Hub (sin administrador, instalador firmado, Gateway WSL autogestionado); la App de la barra de menús de macOS exige macOS 26.2+.
✅ Ya sabes ejecutar Docker: OPENCLAW_IMAGE + ./scripts/docker/setup.sh, el onboarding se completa automáticamente, la Control UI está en 18789.
✅ Recordaste los escollos de parámetros de la instalación directa: npm 12 / 11.16+ con --allow-scripts=openclaw, pnpm con --allow-build=openclaw, Bun con --trust.
Repaso de los comandos clave:
| Ruta | Comando / archivo clave | Descripción |
|---|---|---|
| Windows Hub | OpenClawCompanion-Setup-x64.exe / -arm64.exe | Versión de escritorio para Windows recomendada oficialmente; instalación sin administrador |
| Barra de menús de macOS | OpenClaw-<version>.dmg | Requiere macOS 26.2 (Tahoe) + |
| Alternativa para Windows | OpenClaw-<version>-windows-x86_64.exe | App de escritorio Tauri, puede incluir Bun |
| Docker | OPENCLAW_IMAGE + ./scripts/docker/setup.sh | GHCR como canal principal; imagen en Docker Hub openclaw/openclaw |
| npm | npm install -g openclaw@latest --allow-scripts=openclaw | npm 12 / 11.16+; en 11.15 y anteriores, quita el parámetro |
| pnpm | pnpm add -g --allow-build=openclaw openclaw@latest | approve-builds -g no admite instalación global |
| Bun | bun add -g --trust openclaw@latest | Bun 1.4.4+; Node sigue siendo el runtime principal |
| Código fuente | pnpm install && pnpm build && pnpm ui:build | Corepack elige la versión de pnpm según package.json |
| Verificación común | openclaw --version / openclaw doctor / openclaw gateway status | Ejecutar tras completar cualquier ruta |
La lista completa de consulta rápida de comandos está en Consulta rápida de comandos y configuración de la CLI.
Avance de la próxima lección
Una vez que pongas en marcha cualquiera de las cuatro rutas alternativas, llega la lección de respaldo como cierre: Qué hacer si no se instala o no arranca: solución de problemas de instalación e inicio.
Aprenderás:
- Pasos de diagnóstico para errores durante la instalación como una versión de Node insuficiente o
openclaw command not found - Cómo diagnosticar cuando el Gateway no arranca
- Cómo gestionar fallos de actualización