Aspectos internos del instalador

Internos del instalador

OpenClaw incluye tres scripts de instalación, servidos desde openclaw.ai.

Script	Plataforma	Lo que hace
install.sh	macOS / Linux / WSL	Instala Node si es necesario, instala OpenClaw a través de npm (predeterminado) o git, y puede ejecutar la incorporación.
install-cli.sh	macOS / Linux / WSL	Instala Node + OpenClaw en un prefijo local (~/.openclaw). No se requieren permisos de root.
install.ps1	Windows (PowerShell)	Instala Node si es necesario, instala OpenClaw a través de npm (predeterminado) o git, y puede ejecutar la incorporación.

Comandos rápidos

install.shinstall-cli.shinstall.ps1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

Note

Si la instalación tiene éxito pero

openclaw

no se encuentra en una nueva terminal, consulta

solución de problemas de Node.js

.

---

install.sh

Tip

Recomendado para la mayoría de las instalaciones interactivas en macOS/Linux/WSL.

Flujo (install.sh)

1. Detectar SO

   Soporta macOS y Linux (incluyendo WSL). Si se detecta macOS, instala Homebrew si falta.

2. Asegurar Node.js 24 por defecto

   Verifica la versión de Node e instala Node 24 si es necesario (Homebrew en macOS, scripts de configuración de NodeSource en Linux apt/dnf/yum). OpenClaw todavía soporta Node 22 LTS, actualmente 22.14+, por compatibilidad.

3. Asegurar Git

   Instala Git si falta.

4. Instalar OpenClaw

   • método npm (predeterminado): instalación global npm - método git: clonar/actualizar repositorio, instalar dependencias con pnpm, compilar, luego instalar wrapper en ~/.local/bin/openclaw

5. Tareas posteriores a la instalación

   • Ejecuta openclaw doctor --non-interactive en actualizaciones e instalaciones git (mejor esfuerzo) - Intenta el onboarding cuando es apropiado (TTY disponible, onboarding no deshabilitado, y las verificaciones de bootstrap/config pasan) - Establece por defecto SHARP_IGNORE_GLOBAL_LIBVIPS=1

Detección de checkout de código fuente

Si se ejecuta dentro de un checkout de OpenClaw (package.json + pnpm-workspace.yaml), el script ofrece:

• usar checkout (git), o
• usar instalación global (npm)

Si no hay TTY disponible y no se establece ningún método de instalación, por defecto es npm y advierte.

El script sale con el código 2 para una selección de método no válida o valores --install-method no válidos.

Ejemplos (install.sh)

DefaultSkip onboardingGit installGitHub main via npmDry run

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --version main

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run

Referencia de banderas

Bandera	Descripción
--install-method npm|git	Elegir método de instalación (predeterminado: npm). Alias: --method
--npm	Acceso directo para el método npm
--git	Acceso directo para el método git. Alias: --github
`—version

| versión de npm, dist-tag o especificación de paquete (predeterminado:latest) | | —beta | Usar dist-tag beta si está disponible, de lo contrario volver alatest | |—git-dir

| Directorio de checkout (predeterminado:~/openclaw). Alias: —dir | |—no-git-update | Saltargit pullpara checkout existente | |—no-prompt | Desactivar preguntas | |—no-onboard | Saltar incorporación | |—onboard | Activar incorporación | |—dry-run | Imprimir acciones sin aplicar cambios | |—verbose | Activar salida de depuración (set -x, registros de nivel de aviso de npm) | | —help | Mostrar uso (-h`) |

Referencia de variables de entorno

Variable	Descripción
OPENCLAW_INSTALL_METHOD=git|npm	Método de instalación
`OPENCLAW_VERSION=latest|next|main|

|

| versión de npm, etiqueta de distribución o especificación de paquete | |OPENCLAW_BETA=0|1 | Usar beta si está disponible | |OPENCLAW_GIT_DIR=

| Directorio de checkout | |OPENCLAW_GIT_UPDATE=0|1 | Alternar actualizaciones de git | |OPENCLAW_NO_PROMPT=1 | Desactivar indicadores | |OPENCLAW_NO_ONBOARD=1 | Omitir incorporación (onboarding) | |OPENCLAW_DRY_RUN=1 | Modo de simulación (dry run) | |OPENCLAW_VERBOSE=1 | Modo de depuración | |OPENCLAW_NPM_LOGLEVEL=error|warn|notice | nivel de registro de npm | |SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 | Controlar el comportamiento de sharp/libvips (predeterminado:1`) |

---

install-cli.sh

Info

Diseñado para entornos donde desea tener todo bajo un prefijo local (predeterminado

~/.openclaw

) y sin dependencia del Node del sistema.

Flujo (install-cli.sh)

1. Instalar el entorno de ejecución de Node local

   Descarga un archivo tarball fijado de una versión LTS de Node compatible (la versión está incrustada en el script y se actualiza de forma independiente) a `

   /tools/node-v

   ` y verifica el SHA-256.

2. Asegurar Git

   Si falta Git, intenta la instalación mediante apt/dnf/yum en Linux o Homebrew en macOS.

3. Instalar OpenClaw bajo el prefijo

   Instala con npm usando `—prefix

   , luego escribe un contenedor en

   /bin/openclaw`.

Ejemplos (install-cli.sh)

DefaultCustom prefix + versionAutomation JSON outputRun onboarding

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard

Referencia de marcas

Marca	Descripción
`—prefix

| Prefijo de instalación (predeterminado:~/.openclaw) | | —version

| Versión de OpenClaw o dist-tag (predeterminado:latest) | | —node-version

| Versión de Node (predeterminado:22.22.0) | | —json | Emitir eventos NDJSON | |—onboard | Ejecutaropenclaw onboarddespués de la instalación | |—no-onboard | Saltar onboarding (predeterminado) | |—set-npm-prefix | En Linux, forzar el prefijo de npm a~/.npm-globalsi el prefijo actual no es escribible | |—help | Mostrar uso (-h`) |

Referencia de variables de entorno

Variable	Descripción
`OPENCLAW_PREFIX=

| Prefijo de instalación | |OPENCLAW_VERSION=

| Versión de OpenClaw o dist-tag | |OPENCLAW_NODE_VERSION=

| Versión de Node | |OPENCLAW_NO_ONBOARD=1 | Saltar onboarding | |OPENCLAW_NPM_LOGLEVEL=error|warn|notice| Nivel de registro de npm | |OPENCLAW_GIT_DIR=

| Ruta de búsqueda de limpieza heredada (usada al eliminar el checkout antiguo del submóduloPeekaboo) | | SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 | Controlar el comportamiento de sharp/libvips (predeterminado:1`) |

---

install.ps1

Flujo (install.ps1)

1. Asegurar el entorno de PowerShell + Windows

   Requiere PowerShell 5+.

2. Asegurar Node.js 24 por defecto

   Si falta, intenta la instalación vía winget, luego Chocolatey y luego Scoop. Node 22 LTS, actualmente 22.14+, sigue siendo compatible por compatibilidad.

3. Instalar OpenClaw

   • método npm (predeterminado): instalación global de npm usando -Tag seleccionado - método git: clonar/actualizar repositorio, instalar/construir con pnpm, e instalar contenedor en %USERPROFILE%\.local\bin\openclaw.cmd

4. Tareas posteriores a la instalación

   Añade el directorio bin necesario al PATH del usuario cuando es posible, luego ejecuta openclaw doctor --non-interactive en actualizaciones e instalaciones de git (mejor esfuerzo).

Ejemplos (install.ps1)

DefaultGit installGitHub main via npmCustom git directoryDry runDebug trace

powershell iwr -useb https://openclaw.ai/install.ps1 | iex

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag main

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun

powershell # install.ps1 has no dedicated -Verbose flag yet. Set-PSDebug -Trace 1 & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard Set-PSDebug -Trace 0

Referencia de banderas

Bandera	Descripción
-InstallMethod npm|git	Método de instalación (predeterminado: npm)
`-Tag

| dist-tag de npm, versión o especificación de paquete (predeterminado:latest) | | -GitDir

| Directorio de checkout (predeterminado:%USERPROFILE%\openclaw) | | -NoOnboard | Saltar onboarding | |-NoGitUpdate | Saltargit pull | |-DryRun` | Imprimir solo las acciones |

Referencia de variables de entorno

Variable	Descripción
OPENCLAW_INSTALL_METHOD=git|npm	Método de instalación
`OPENCLAW_GIT_DIR=

| Directorio de checkout | |OPENCLAW_NO_ONBOARD=1 | Saltar onboarding | |OPENCLAW_GIT_UPDATE=0 | Desactivar git pull | |OPENCLAW_DRY_RUN=1` | Modo de prueba |

Note

Si se usa

-InstallMethod git

y falta Git, el script sale e imprime el enlace de Git para Windows.

---

CI y automatización

Utilice indicadores/variables de entorno no interactivos para ejecuciones predecibles.

install.sh (non-interactive npm)install.sh (non-interactive git)install-cli.sh (JSON)install.ps1 (skip onboarding)

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

bash OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \ curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

---

Solución de problemas

¿Por qué se requiere Git?

Se requiere Git para el método de instalación git. Para las instalaciones npm, Git aún se verifica/installa para evitar fallos de spawn git ENOENT cuando las dependencias usan URLs de git.

¿Por qué npm encuentra EACCES en Linux?

Problemas con sharp/libvips

Los scripts establecen SHARP_IGNORE_GLOBAL_LIBVIPS=1 por defecto para evitar que sharp compile contra libvips del sistema. Para anularlo:

SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Windows: "npm error spawn git / ENOENT"

Instale Git para Windows, vuelva a abrir PowerShell, ejecute el instalador nuevamente.

Windows: "openclaw no se reconoce"

Ejecute npm config get prefix y añada ese directorio a su PATH de usuario (no se necesita el sufijo \bin en Windows), luego vuelva a abrir PowerShell.

Windows: cómo obtener una salida detallada del instalador

install.ps1 actualmente no expone un interruptor -Verbose. Utilice el seguimiento de PowerShell para diagnósticos a nivel de script:

Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

openclaw no encontrado después de la instalación

Generalmente es un problema de PATH. Consulte Solución de problemas de Node.js.