Instalar¶

¿Ya siguió Primeros pasos? Todo listo — esta página es para métodos de instalación alternativos, instrucciones específicas por plataforma y mantenimiento.

Requisitos del sistema¶

• Node 22+ (el script de instalación lo instalará si falta)
• macOS, Linux o Windows
• pnpm solo si compila desde el código fuente

En Windows, recomendamos encarecidamente ejecutar OpenClaw bajo WSL2.

Métodos de instalación¶

El script de instalación es la forma recomendada de instalar OpenClaw. Gestiona la detección de Node, la instalación y el onboarding en un solo paso.

Descarga la CLI, la instala globalmente mediante npm y lanza el asistente de onboarding.

```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

Eso es todo — el script gestiona la detección de Node, la instalación y el onboarding.

Para omitir el onboarding e instalar solo el binario:

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

Para todas las flags, variables de entorno y opciones de CI/automatización, consulte [Internos del instalador](/install/installer).
```

Si ya tiene Node 22+ y prefiere gestionar la instalación usted mismo:

```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="¿errores de compilación de sharp?">
      Si tiene libvips instalado globalmente (común en macOS vía Homebrew) y `sharp` falla, fuerce los binarios precompilados:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      Si ve `sharp: Please add node-gyp to your dependencies`, instale las herramientas de compilación (macOS: Xcode CLT + `npm install -g node-gyp`) o use la variable de entorno anterior.
    </Accordion>
  </Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    <Note>
    pnpm requiere aprobación explícita para paquetes con scripts de compilación. Después de que la primera instalación muestre la advertencia "Ignored build scripts", ejecute `pnpm approve-builds -g` y seleccione los paquetes listados.
    </Note>
  </Tab>
</Tabs>
```

Para colaboradores o cualquiera que quiera ejecutar desde un checkout local.

```
<Steps>
  <Step title="Clonar y compilar">
    Clone el [repositorio de OpenClaw](https://github.com/openclaw/openclaw) y compile:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```
  </Step>
  <Step title="Vincular la CLI">
    Haga que el comando `openclaw` esté disponible globalmente:

    ```bash
    pnpm link --global
    ```

    Alternativamente, omita el vínculo y ejecute los comandos mediante `pnpm openclaw ...` desde dentro del repositorio.
  </Step>
  <Step title="Ejecutar onboarding">
    ```bash
    openclaw onboard --install-daemon
    ```
  </Step>
</Steps>

Para flujos de trabajo de desarrollo más profundos, consulte [Configuración](/start/setup).
```

Otros métodos de instalación¶

Implementaciones en contenedores o sin interfaz. Instalación declarativa mediante Nix. Aprovisionamiento automatizado de flotas. Uso solo de la CLI mediante el runtime Bun.

Después de instalar¶

Verifique que todo esté funcionando:

openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI

Si necesitas rutas de ejecución personalizadas, utiliza:

• OPENCLAW_HOME para rutas internas basadas en el directorio home
• OPENCLAW_STATE_DIR para la ubicación del estado mutable
• OPENCLAW_CONFIG_PATH para la ubicación del archivo de configuración

Consulta Environment vars para conocer la precedencia y todos los detalles.

Solución de problemas: openclaw no encontrado¶

Diagnóstico rápido:

node -v
npm -v
npm prefix -g
echo "$PATH"

Si $(npm prefix -g)/bin (macOS/Linux) o $(npm prefix -g) (Windows) no está en su $PATH, su shell no puede encontrar los binarios globales de npm (incluido openclaw).

Corrección — agréguelo a su archivo de inicio del shell (~/.zshrc o ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

En Windows, agregue la salida de npm prefix -g a su PATH.

Luego abra una nueva terminal (o ejecute rehash en zsh / hash -r en bash).

Actualizar / desinstalar¶

Mantenga OpenClaw actualizado. Muévase a una nueva máquina. Elimine OpenClaw por completo.