Detalles internos del instalador

Detectar el sistema operativo

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. Las fuentes de paquetes estables actuales de Alpine pueden proporcionar una versión de Node suficientemente nueva 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 o actualiza el repositorio, instala las dependencias con pnpm, compila y, a continuación, instala el contenedor de comandos 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 configuración inicial antes de las comprobaciones de doctor o del Gateway. Con --no-onboard o sin TTY, muestra el comando para completar 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 ponen al día los plugins cuando es posible o muestran el comando manual en una ejecución sin interfaz con las 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; valor predeterminado: 24.15.0) 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 con el entorno de ejecución fijado, instala nodejs y npm con apk y, a continuación, verifica tanto Node como la biblioteca SQLite realmente enlazada. Las fuentes de paquetes estables actuales de Alpine todavía pueden enlazar una versión vulnerable de SQLite incluso con una versión de Node suficientemente nueva; 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): instala bajo el prefijo mediante npm y, a continuación, escribe el contenedor de comandos en <prefix>/bin/openclaw
• Método git: clona o actualiza una copia de trabajo (valor predeterminado: ~/openclaw) y también escribe el contenedor de comandos 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, que activa el servicio de sustitución, y, a continuación, comprueba el estado del Gateway en la medida de lo posible.

Garantizar un entorno de PowerShell y Windows

Requiere PowerShell 5+.

Garantizar Node.js 24 de forma predeterminada

Si no está disponible, intenta instalarlo mediante winget, después Chocolatey y, por último, Scoop. Si no hay ningún gestor de paquetes disponible, el script descarga el 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 de npm mediante el -Tag seleccionado, iniciada desde un directorio temporal del instalador con permisos de escritura para que las consolas abiertas en carpetas protegidas como C:\ sigan funcionando
• Método git: clona/actualiza el repositorio, instala/compila con pnpm e instala el contenedor en %USERPROFILE%\.local\bin\openclaw.cmd. Si Git no está disponible, el script instala MinGit localmente 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.