Instalación

¿Ya seguiste Primeros pasos? Entonces estás listo — esta página cubre métodos de instalación alternativos, instrucciones específicas por plataforma y mantenimiento.

Requisitos del sistema

Node 24 (recomendado) (Node 22 LTS, actualmente 22.16+, sigue siendo compatible; el script de instalación instalará Node 24 si no lo tienes)
macOS, Linux o Windows
pnpm solo si compilas desde el código fuente

Nota: En Windows, recomendamos encarecidamente ejecutar OpenClaw bajo WSL2.

Métodos de instalación

Consejo: El script de instalación es la forma recomendada de instalar OpenClaw. Se encarga de detectar Node, instalarlo y ejecutar el asistente de configuración en un solo paso.

Advertencia: Para VPS/hosts en la nube, evita las imágenes de marketplace “1-click” de terceros cuando sea posible. Es mejor usar una imagen base limpia del sistema operativo (por ejemplo Ubuntu LTS) e instalar OpenClaw tú mismo con el script de instalación.

Script de instalación

Descarga el CLI, lo instala globalmente vía npm y lanza el asistente de configuración.


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



Eso es todo — el script se encarga de detectar Node, instalarlo y ejecutar la configuración inicial.

Para saltar la configuración inicial e instalar solo el binario:


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```

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



Para ver todos los flags, variables de entorno y opciones de CI/automatización, consulta [Detalles del instalador](/docs/install/installer).

npm / pnpm

Si ya gestionas Node por tu cuenta, recomendamos Node 24. OpenClaw sigue siendo compatible con Node 22 LTS, actualmente `22.16+`:


  #### npm
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <details>

¿Errores de compilación de sharp?

      Si tienes libvips instalado globalmente (común en macOS vía Homebrew) y `sharp` falla, fuerza los binarios precompilados:

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

      Si ves `sharp: Please add node-gyp to your dependencies`, instala las herramientas de compilación (macOS: Xcode CLT + `npm install -g node-gyp`) o usa la variable de entorno anterior.
    </details>

  #### pnpm
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # aprueba openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    > **Nota:** pnpm requiere aprobación explícita para paquetes con scripts de compilación. Después de la primera instalación, si aparece el aviso "Ignored build scripts", ejecuta `pnpm approve-builds -g` y selecciona los paquetes listados.

Desde el código fuente

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


  ### Paso 1: Clonar y compilar
    Clona el [repositorio de OpenClaw](https://github.com/openclaw/openclaw) y compila:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```

  ### Paso 2: Vincular el CLI
    Haz que el comando `openclaw` esté disponible globalmente:

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

    Alternativamente, sáltate el vínculo y ejecuta comandos con `pnpm openclaw ...` desde dentro del repositorio.

  ### Paso 3: Ejecutar la configuración inicial
    ```bash
    openclaw onboard --install-daemon
    ```



Para flujos de desarrollo más avanzados, consulta [Setup](/docs/start/setup).

Otros métodos de instalación

Docker — Despliegues containerizados o headless.
Podman — Contenedor rootless: ejecuta setup-podman.sh una vez, luego usa el script de inicio.
Nix — Instalación declarativa con Nix.
Ansible — Aprovisionamiento automatizado de flotas.
Bun — Uso solo del CLI con el runtime Bun.

Después de instalar

Verifica que todo funciona correctamente:

openclaw doctor         # comprueba problemas de configuración
openclaw status         # estado del gateway
openclaw dashboard      # abre la interfaz del navegador

Si necesitas rutas de runtime personalizadas:

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 Variables de entorno para la precedencia y todos los detalles.

Solución de problemas: `openclaw` no encontrado

Diagnóstico y corrección del PATH

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 tu $PATH, tu shell no puede encontrar los binarios globales de npm (incluido openclaw).

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

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

En Windows, agrega la salida de npm prefix -g a tu PATH.

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

Actualizar / desinstalar

Actualización — Mantén OpenClaw al día.
Migración — Mover a una nueva máquina.
Desinstalar — Eliminar OpenClaw completamente.