Detalles internos del instalador

Detectar el SO

Admite macOS y Linux (incluido WSL).

Garantizar Node.js 24 de forma predeterminada

Comprueba la versión de Node e instala Node 24 si es necesario (Homebrew en macOS y scripts de configuración de NodeSource en Linux con apt/dnf/yum). En macOS, Homebrew solo se instala cuando el instalador lo necesita para Node o Git. Se admiten Node 22.22.3+, Node 24.15+ y Node 25.9+; Node 23 no es compatible. En Alpine/Linux con musl, el instalador utiliza paquetes apk en lugar de NodeSource y verifica la versión real de SQLite enlazada. Los canales actuales de paquetes estables de Alpine pueden proporcionar una versión suficientemente reciente de Node con una versión vulnerable de SQLite del sistema; cuando esto ocurra, utilice en su lugar un contenedor oficial node:24-alpine o un host basado en glibc.

Garantizar Git

Instala Git si falta mediante el gestor de paquetes detectado, incluidos Homebrew en macOS y apk en Alpine.

Instalar OpenClaw

• Método npm (predeterminado): instalación global mediante npm
• Método git: clona/actualiza el repositorio, instala las dependencias con pnpm, compila y, a continuación, instala el contenedor en ~/.local/bin/openclaw

Tareas posteriores a la instalación

• Resuelve el binario openclaw recién instalado para los comandos posteriores
• En una instalación sin configurar, inicia la incorporación antes de las comprobaciones de doctor o Gateway. Con --no-onboard o sin TTY, muestra el comando para finalizar la configuración más adelante.
• En una instalación configurada, actualiza y reinicia, en la medida de lo posible, un servicio Gateway cargado y ejecuta doctor. Las actualizaciones actualizan los plugins cuando es posible o muestran el comando manual en una ejecución sin interfaz con solicitudes habilitadas.
• Cuando se ejecuta --verify, comprueba la versión instalada y solo comprueba el estado del Gateway después de que exista la configuración.

Instalar el entorno de ejecución local de Node

Descarga un archivo tar de una versión LTS compatible y fijada de Node (la versión está integrada en el script y se actualiza de forma independiente; 24.15.0 de forma predeterminada) en <prefix>/tools/node-v<version> y verifica su SHA-256. Linux ARMv7 utiliza Node 22.22.3 porque no hay binarios oficiales de Node 24+ disponibles para ARMv7. En Alpine/Linux con musl, donde Node no publica archivos tar compatibles para el entorno de ejecución fijado, instala nodejs y npm con apk y, a continuación, verifica tanto Node como la biblioteca SQLite real enlazada. Los canales actuales de paquetes estables de Alpine pueden seguir enlazando una versión vulnerable de SQLite incluso con una versión suficientemente reciente de Node; utilice un contenedor oficial node:24-alpine o un host basado en glibc cuando la comprobación de seguridad rechace el paquete.

Garantizar Git

Si falta Git, intenta instalarlo mediante apt/dnf/yum/apk en Linux o Homebrew en macOS.

Instalar OpenClaw bajo el prefijo

• Método npm (predeterminado): lo instala bajo el prefijo con npm y, a continuación, escribe el contenedor en <prefix>/bin/openclaw
• Método git: clona/actualiza un checkout (~/openclaw de forma predeterminada) y también escribe el contenedor en <prefix>/bin/openclaw

Actualizar el servicio Gateway cargado

Si ya hay un servicio Gateway cargado desde ese mismo prefijo, el script ejecuta openclaw gateway install --force, después openclaw gateway restart, y comprueba el estado del Gateway en la medida de lo posible.

Garantizar el entorno de PowerShell y Windows

Requiere PowerShell 5+.

Garantizar Node.js 24 de forma predeterminada

Si falta, intenta instalarlo mediante winget, después Chocolatey y, por último, Scoop. Si no hay ningún gestor de paquetes disponible, el script descarga el archivo zip oficial de Node.js 24 para Windows en %LOCALAPPDATA%\OpenClaw\deps\portable-node y lo añade al PATH del proceso actual y del usuario. Se admiten Node 22.22.3+, Node 24.15+ y Node 25.9+; Node 23 no es compatible.

Instalar OpenClaw

• Método npm (predeterminado): instalación global mediante npm usando el -Tag seleccionado, iniciada desde un directorio temporal de instalación con permisos de escritura para que las shells abiertas en carpetas protegidas como C:\ sigan funcionando
• Método git: clona o actualiza el repositorio, instala y compila con pnpm e instala el contenedor en %USERPROFILE%\.local\bin\openclaw.cmd. Si falta Git, el script inicializa MinGit de forma local para el usuario en %LOCALAPPDATA%\OpenClaw\deps\portable-git y lo añade al PATH del proceso actual y del usuario.

Tareas posteriores a la instalación

• Añade el directorio bin necesario al PATH del usuario cuando es posible
• Actualiza, en la medida de lo posible, un servicio Gateway cargado (openclaw gateway install --force y después reinicio)
• Ejecuta openclaw doctor --non-interactive en actualizaciones e instalaciones mediante git (en la medida de lo posible)

Gestionar errores

Las instalaciones mediante iwr ... | iex y bloques de script notifican un error de terminación sin cerrar la sesión actual de PowerShell. Las instalaciones directas mediante powershell -File / pwsh -File siguen finalizando con un código distinto de cero para permitir la automatización.