Internos del Instalador

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

Comandos rápidos

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

ℹ️ 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

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

Flujo (install.sh)

Paso 1: Detectar SO

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

Paso 2: Asegurar Node.js 22+

Verifica la versión de Node e instala Node 22 si es necesario (Homebrew en macOS, scripts de configuración de NodeSource en apt/dnf/yum de Linux).

Paso 3: Asegurar Git

Instala Git si falta.

Paso 4: Instalar OpenClaw

• Método npm (por defecto): instalación global con npm
• Método git: clona/actualiza el repositorio, instala dependencias con pnpm, construye, luego instala el wrapper en ~/.local/bin/openclaw

Paso 5: Tareas posteriores a la instalación

• Ejecuta openclaw doctor --non-interactive en actualizaciones e instalaciones git (mejor esfuerzo)
• Intenta la configuración inicial cuando es apropiado (TTY disponible, configuración inicial no deshabilitada, y las comprobaciones 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 el checkout (git), o
• usar la instalación global (npm)

Si no hay TTY disponible y no se establece un método de instalación, por defecto usa npm y advierte. El script sale con código 2 para selección de método inválida o valores inválidos de --install-method.

Ejemplos (install.sh)

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

install-cli.sh

ℹ️ Diseñado para entornos donde se quiere todo bajo un prefijo local (por defecto ~/.openclaw) y sin dependencia de Node del sistema.

Flujo (install-cli.sh)

Paso 1: Instalar entorno de ejecución Node local

Descarga el tarball de Node (por defecto 22.22.0) a <prefix>/tools/node-v<version> y verifica SHA-256.

Paso 2: Asegurar Git

Si falta Git, intenta instalarlo vía apt/dnf/yum en Linux o Homebrew en macOS.

Paso 3: Instalar OpenClaw bajo el prefijo

Instala con npm usando --prefix <prefix>, luego escribe el wrapper en <prefix>/bin/openclaw.

Ejemplos (install-cli.sh)

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

install.ps1

Flujo (install.ps1)

Paso 1: Asegurar PowerShell + entorno Windows

Requiere PowerShell 5+.

Paso 2: Asegurar Node.js 22+

Si falta, intenta instalarlo vía winget, luego Chocolatey, luego Scoop.

Paso 3: Instalar OpenClaw

• Método npm (por defecto): instalación global con npm usando el -Tag seleccionado
• Método git: clona/actualiza el repositorio, instala/construye con pnpm, e instala el wrapper en %USERPROFILE%\.local\bin\openclaw.cmd

Paso 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 git (mejor esfuerzo).

Ejemplos (install.ps1)

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

ℹ️ Si se usa -InstallMethod git y falta Git, el script sale e imprime el enlace de Git for Windows.

CI y automatización

Usa banderas/variables de entorno no interactivas para ejecuciones predecibles.

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

Solución de problemas

InstalarDocker