Cómo instalar OpenClaw en tu sistema

Instalar herramientas nuevas suele ser frustrante. A veces pasas más tiempo configurando el entorno que usando la herramienta real. Esos problemas de dependencias que faltan o rutas que no funcionan rompen tu flujo de trabajo y te quitan tiempo valioso.

OpenClaw elimina esa fricción con scripts que automatizan la configuración. No tienes que preocuparte por instalar manualmente cada pieza; el instalador detecta qué te falta y lo soluciona por ti.

Requisitos previos

Para ejecutar estos scripts, solo necesitas cumplir con estos puntos:

• macOS, Linux o WSL.
• Windows con PowerShell.
• Conexión a internet para descargar los componentes.
• Node.js (si no lo tienes, el script intentará instalarlo).

Inicio rápido

OpenClaw ofrece tres scripts principales desde openclaw.ai. Elige el que mejor se adapte a tu plataforma y necesidades.

Script	Platform	Qué hace
install.sh	macOS / Linux / WSL	Instala Node.js si es necesario, instala OpenClaw vía npm o git, y ejecuta el onboarding.
install-cli.sh	macOS / Linux / WSL	Instala Node.js y OpenClaw en un prefijo local (~/.openclaw). No requiere root.
install.ps1	Windows (PowerShell)	Instala Node.js si es necesario, instala OpenClaw vía npm o git, y ejecuta el onboarding.

Comandos rápidos

Elige tu terminal y pega el comando correspondiente:

Para macOS / Linux / WSL (Instalación estándar):

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

Si necesitas ver las opciones disponibles:

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

Para macOS / Linux / WSL (Sin root):

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

Para ver opciones adicionales:

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

Para Windows (PowerShell):

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

Para una instalación avanzada (ejemplo con flags):

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

Solución de problemas

Si la instalación termina correctamente pero no puedes ejecutar el comando openclaw en una terminal nueva, revisa la sección de Node.js troubleshooting.

¿Necesitas ayuda personalizada con tu configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Configuración de Node.js
• Guía de uso de la CLI

Configurar un entorno de desarrollo suele ser una tarea pesada. Entre versiones de Node.js que no coinciden y dependencias globales que faltan, es fácil perder el hilo antes de escribir la primera línea de código.

He probado varias formas de configurar herramientas similares y, sinceramente, automatizar el proceso es la mejor opción para evitar errores manuales. El script `install.sh` de OpenClaw se encarga de todo el trabajo sucio por ti, asegurando que tu sistema tenga exactamente lo que necesita para funcionar.

## Requisitos previos

- macOS o Linux (incluyendo WSL).

## Inicio rápido

Si quieres tener OpenClaw funcionando en menos de 5 minutos, te recomiendo el método interactivo. Es el camino más corto y confiable para la mayoría de los usuarios.

### 1. Ejecuta el instalador
Copia y pega este comando en tu terminal:

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

2. Flujo de instalación

El script ejecutará estas acciones automáticamente:

1. Detectar OS: Soporta macOS y Linux. Si estás en macOS, instalará Homebrew si no lo tienes.
2. Asegurar Node.js 22+: Verifica tu versión de Node.js e instala Node 22 si es necesario (vía Homebrew en macOS o NodeSource en Linux).
3. Asegurar Git: Instala Git en caso de que falte en tu sistema.
4. Instalar OpenClaw:
   • Por defecto usa el método npm (instalación global).
   • Permite el método git (clona el repo, instala dependencias con pnpm y crea un wrapper en ~/.local/bin/openclaw).
5. Tareas post-instalación: Ejecuta openclaw doctor y configura el entorno inicial.

Detección de Source checkout

Si ejecutas el script dentro de una carpeta que ya tiene OpenClaw (donde existan package.json y pnpm-workspace.yaml), el script te preguntará si prefieres usar esa versión local (git) o la instalación global (npm).

Ejemplos de uso

Aquí tienes diferentes formas de ejecutar el script según tus necesidades:

Default:

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

Skip onboarding:

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

Git install:

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

Dry run:

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

Referencia de Flags y Variables

Si necesitas un control total sobre la instalación, puedes usar estos CLI flags:

Flag	Description
--install-method npm|git	Elige el método de instalación (default: npm). Alias: --method
--npm	Atajo para el método npm
--git	Atajo para el método git. Alias: --github
--version <version|dist-tag>	Versión de npm o dist-tag (default: latest)
--beta	Usa el tag beta si está disponible
--git-dir <path>	Directorio de checkout (default: ~/openclaw). Alias: --dir
--no-git-update	Omite git pull en checkouts existentes
--no-prompt	Desactiva los prompts interactivos
--no-onboard	Omite el proceso de onboarding
--onboard	Fuerza el proceso de onboarding
--dry-run	Muestra las acciones sin aplicar cambios
--verbose	Activa el output de depuración
--help	Muestra la ayuda (-h)

También puedes configurar el comportamiento mediante variables de entorno:

Variable	Description
OPENCLAW_INSTALL_METHOD=git|npm	Método de instalación
OPENCLAW_VERSION=latest|next|<semver>	Versión de npm o dist-tag
OPENCLAW_BETA=0|1	Activa el uso de beta
OPENCLAW_GIT_DIR=<path>	Directorio para el método git
OPENCLAW_GIT_UPDATE=0|1	Activa o desactiva actualizaciones de git
OPENCLAW_NO_PROMPT=1	Desactiva prompts
OPENCLAW_NO_ONBOARD=1	Omite onboarding
OPENCLAW_DRY_RUN=1	Modo dry run
OPENCLAW_VERBOSE=1	Modo debug
OPENCLAW_NPM_LOGLEVEL=error|warn|notice	Nivel de logs de npm
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1	Controla el comportamiento de sharp/libvips (default: 1)

Solución de problemas

Si encuentras problemas durante la ejecución, ten en cuenta lo siguiente:

• Código de salida 2: El script terminará con este código si seleccionas un método inválido o si pasas un valor no admitido en --install-method.
• Sin TTY: Si ejecutas el script en un entorno sin terminal interactiva (no TTY) y no defines un método, el script usará npm por defecto y mostrará una advertencia.

¿Necesitas ayuda personalizada para tu configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Configuración de CLI
• Guía de actualización
• Uso de pnpm en OpenClaw
• Troubleshooting avanzado

---
title: "Instalación de OpenClaw con install-cli.sh"
description: "Aprende a instalar OpenClaw de forma aislada usando el script install-cli.sh, gestionando versiones locales de Node.js y configuraciones personalizadas."
---

Instalar herramientas nuevas suele ser un dolor de cabeza cuando ensucian tus directorios globales o rompen las versiones de Node.js que ya tienes configuradas. A veces solo quieres que todo funcione de forma aislada, sin dramas y sin afectar al resto de tus proyectos.

Para mantener tu sistema limpio, lo mejor es usar un script que gestione su propio entorno. `install-cli.sh` es la solución ideal porque instala todo bajo un prefijo local, evitando conflictos de dependencias y asegurando que tengas exactamente lo que necesitas para ejecutar OpenClaw.

## Requisitos previos

Antes de empezar, asegúrate de cumplir con estos requisitos:

- Una terminal (Bash o Zsh)
- Conexión a internet para descargar los binarios
- Permisos de escritura en el directorio de instalación (por defecto `~`)
- Git instalado (aunque el script intentará instalarlo por ti si falta)

## Inicio rápido

El script `install-cli.sh` está diseñado para entornos donde quieres que todo viva bajo un prefijo local (por defecto `~/.openclaw`) y no quieres depender del Node.js del sistema.

### Flujo de instalación

1. **Instalación del runtime de Node local**: Descarga el tarball de Node (versión `22.22.0` por defecto) en `<prefix>/tools/node-v<version>` y verifica su integridad con SHA-256.
2. **Verificación de Git**: Si no detecta Git, intenta instalarlo usando apt/dnf/yum en Linux o Homebrew en macOS.
3. **Instalación de OpenClaw**: Ejecuta la instalación con npm usando `--prefix <prefix>` y genera un wrapper en `<prefix>/bin/openclaw`.

### Ejemplos de uso

**Instalación por defecto**
```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

Prefijo y versión personalizados

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

Salida en formato JSON para automatización

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

Ejecutar onboarding tras la instalación

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

Referencia de Flags

Flag	Descripción
--prefix <path>	Prefijo de instalación (por defecto: ~/.openclaw)
--version <ver>	Versión de OpenClaw o dist-tag (por defecto: latest)
--node-version <ver>	Versión de Node (por defecto: 22.22.0)
--json	Emite eventos en formato NDJSON
--onboard	Ejecuta openclaw onboard después de instalar
--no-onboard	Omite el onboarding (comportamiento por defecto)
--set-npm-prefix	En Linux, fuerza el prefijo de npm a ~/.npm-global si el actual no tiene permiso
--help	Muestra la ayuda de uso (-h)

Variables de entorno

Variable	Descripción
OPENCLAW_PREFIX=<path>	Prefijo de instalación
OPENCLAW_VERSION=<ver>	Versión de OpenClaw o dist-tag
OPENCLAW_NODE_VERSION=<ver>	Versión de Node
OPENCLAW_NO_ONBOARD=1	Omite el onboarding
OPENCLAW_NPM_LOGLEVEL=error|warn|notice	Nivel de log de npm
OPENCLAW_GIT_DIR=<path>	Ruta de búsqueda para limpieza de legado (submódulo Peekaboo antiguo)
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1	Controla el comportamiento de sharp/libvips (por defecto: 1)

Solución de problemas

Si encuentras problemas durante la instalación, estas son las soluciones a los fallos más comunes documentados:

• El prefijo de instalación no tiene permisos de escritura: Si estás en Linux y el prefijo actual falla, usa el flag --set-npm-prefix para redirigir la instalación a ~/.npm-global.
• Errores con librerías de imágenes: Si tienes conflictos con sharp o libvips, asegúrate de que la variable SHARP_IGNORE_GLOBAL_LIBVIPS esté en 1 (es el valor predeterminado) para que use las versiones internas.

Si necesitas ayuda personalizada con tu configuración, puedes consultar al AI Setup Assistant.

Próximos pasos

• Configuración de comandos CLI
• Guía de actualización de OpenClaw

```mdx
---
title: "Instalación de OpenClaw con install.ps1"
description: "Aprende a instalar y configurar OpenClaw en Windows de forma automatizada usando el script oficial de PowerShell."
---

¿Alguna vez has perdido demasiado tiempo configurando variables de entorno o instalando dependencias manualmente? Configurar un entorno de desarrollo no debería ser una tarea pesada que te quite tiempo para programar.

El script `install.ps1` está diseñado para que dejes de pelearte con la terminal y tengas OpenClaw listo en pocos minutos. Se encarga de verificar tu sistema, instalar Node.js si te falta y dejar todo configurado para que solo tengas que empezar a crear.

## Requisitos previos

Antes de ejecutar el script, asegúrate de cumplir con estos requisitos básicos que menciona la documentación:

- Windows con PowerShell 5 o superior.
- Conexión a internet para descargar paquetes.
- Node.js 22+ (si no lo tienes, el script intentará instalarlo por ti).
- Git instalado (solo si planeas usar el método de instalación `git`).

## Inicio rápido

Si quieres el camino más corto y recomendado, usa la instalación por defecto vía `npm`. Solo tienes que abrir tu terminal y ejecutar este comando:

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

Esto es lo que sucede detrás de escena cuando ejecutas el script:

1. Verificación de entorno: El script confirma que estás en Windows y usas PowerShell 5+.
2. Gestión de Node.js: Comprueba si tienes Node.js 22+. Si no lo encuentra, intenta instalarlo usando winget, luego Chocolatey y finalmente Scoop.
3. Instalación de OpenClaw: Por defecto usa npm para una instalación global. Si prefieres el método git, clona el repo, compila con pnpm e instala un wrapper en %USERPROFILE%\.local\bin\openclaw.cmd.
4. Configuración final: Agrega los directorios binarios necesarios a tu PATH y ejecuta openclaw doctor para asegurar que todo funcione correctamente.

Ejemplos de uso

Aquí tienes las formas más comunes de ejecutar el script según lo que necesites:

Default:

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

Git install:

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

Custom git directory:

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

Dry run:

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

Flags reference

Flag	Description
-InstallMethod npm|git	Método de instalación (por defecto: npm)
-Tag <tag>	Tag de distribución de npm (por defecto: latest)
-GitDir <path>	Directorio de descarga (por defecto: %USERPROFILE%\openclaw)
-NoOnboard	Omite el proceso de onboarding
-NoGitUpdate	Omite la ejecución de git pull
-DryRun	Solo imprime las acciones sin ejecutarlas

Environment variables reference

Variable	Description
OPENCLAW_INSTALL_METHOD=git|npm	Método de instalación
OPENCLAW_GIT_DIR=<path>	Directorio de descarga
OPENCLAW_NO_ONBOARD=1	Omitir onboarding
OPENCLAW_GIT_UPDATE=0	Desactivar git pull
OPENCLAW_DRY_RUN=1	Modo dry run

Solución de problemas

Si decides usar -InstallMethod git y no tienes Git instalado en tu sistema, el script se detendrá. En este caso, verás un mensaje de error y el script imprimirá el enlace oficial de Git for Windows para que puedas instalarlo antes de volver a intentarlo.

Nota

Recuerda que para el método git, el script intentará instalar y compilar usando pnpm.

¿Necesitas ayuda personalizada con la configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Configuración de CLI
• Uso de OpenClaw Doctor
• Guía de actualización
• Comandos avanzados

Configurar herramientas en entornos de CI suele ser frustrante cuando los instaladores se detienen a esperar una respuesta manual. No hay nada peor que una pipeline bloqueada porque un script pide una confirmación que nadie puede dar desde la terminal de un servidor.

Para que tus ejecuciones sean predecibles, lo mejor es saltarse los pasos interactivos. Aquí te explico cómo automatizar la instalación de OpenClaw sin fricciones.

### What You'll Need

- Git (obligatorio para el método `git` y para manejar dependencias de npm).
- Node.js y npm si prefieres esa vía de instalación.
- PowerShell (en caso de que trabajes sobre Windows).

### Quick Start

Usa flags no interactivos o variables de entorno para que el proceso corra solo. Estas son las opciones más directas según tu entorno:

**install.sh (npm no interactivo)**
```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

install.sh (git no interactivo)

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

install-cli.sh (JSON)

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

install.ps1 (saltar onboarding)

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

Troubleshooting

Si algo falla durante la automatización, revisa estos puntos basados en los errores más comunes:

¿Por qué es necesario Git? Git es imprescindible para el método de instalación git. Para instalaciones vía npm, el script también verifica o instala Git para evitar errores tipo spawn git ENOENT cuando las dependencias usan URLs de git.

Errores EACCES de npm en Linux Algunas configuraciones de Linux apuntan el prefix global de npm a rutas que pertenecen a root. El script install.sh puede cambiar el prefix a ~/.npm-global y añadir los exports del PATH a tus archivos shell rc si existen.

Problemas con sharp/libvips Los scripts usan por defecto SHARP_IGNORE_GLOBAL_LIBVIPS=1 para evitar que sharp se compile contra la librería libvips del sistema. Si necesitas cambiar este comportamiento, usa:

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

Windows: “npm error spawn git / ENOENT” Instala Git for Windows, reinicia PowerShell y vuelve a lanzar el instalador.

Windows: “openclaw is not recognized” Ejecuta npm config get prefix, añade \bin al resultado y suma ese directorio al PATH de tu usuario. Después, reinicia PowerShell.

openclaw no se encuentra tras la instalación Normalmente es un problema del PATH. Puedes revisar más detalles en la guía de Node.js.

Si tienes dudas específicas sobre tu configuración, consulta al AI Setup Assistant.

What’s Next

• Node.js troubleshooting
• Configuración de Gateway