Instalar

Instalar

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

Requisitos del sistema

• Node 24 (recomendado) (Node 22 LTS, actualmente 22.16+, todavía es compatible por compatibilidad; el script de instalación instalará Node 24 si falta)
• macOS, Linux o Windows
• pnpm solo si compilas desde el código fuente

Note

En Windows, recomendamos encarecidamente ejecutar OpenClaw bajo

WSL2

.

Métodos de instalación

Tip

El

script de instalación

es la forma recomendada de instalar OpenClaw. Maneja la detección de Node, la instalación y el incorporamiento en un solo paso.

Warning

Para hosts VPS/nube, evita las imágenes de mercado de “un clic” de terceros cuando sea posible. Prefiere una imagen base de sistema operativo limpia (por ejemplo Ubuntu LTS) y luego instala OpenClaw tú mismo con el script de instalación.

Script de instalación

Descarga la CLI, la instala globalmente mediante npm e inicia el proceso de incorporación.

macOS / Linux / WSL2Windows (PowerShell)

curl -fsSL https://openclaw.ai/install.sh | bash

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

Eso es todo: el script se encarga de la detección de Node, la instalación y el proceso de incorporación.

Para omitir el proceso de incorporación y simplemente instalar el binario:

macOS / Linux / WSL2Windows (PowerShell)

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

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

Para ver todas las opciones de indicadores, variables de entorno y CI/automatización, consulte Detalles del instalador.

npm / pnpm

Si ya gestionas Node por tu cuenta, recomendamos Node 24. OpenClaw aún es compatible con Node 22 LTS, actualmente 22.16+, por compatibilidad:

npmpnpm

npm install -g openclaw@latest
openclaw onboard --install-daemon

¿Errores de compilación sharp?

Si tienes libvips instalado globalmente (común en macOS a través de Homebrew) y sharp falla, fuerza los binarios precompilados:

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.

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”, ejecuta pnpm approve-builds -g y selecciona los paquetes listados.

¿Quieres el head actual de main en GitHub con una instalación mediante gestor de paquetes?

npm install -g github:openclaw/openclaw#main

pnpm add -g github:openclaw/openclaw#main

Desde el código fuente

Para colaboradores o cualquiera que quiera ejecutar desde una copia local.

1. Clonar y compilar

   Clona el repositorio de OpenClaw y compila:

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

2. Vincular la CLI

   Haz que el comando openclaw esté disponible globalmente:

   pnpm link --global

   Alternativamente, omite el enlace y ejecuta comandos a través de pnpm openclaw ... desde dentro del repositorio.

3. Ejecutar onboarding

   openclaw onboard --install-daemon

Para flujos de trabajo de desarrollo más profundos, consulta Configuración.

Otros métodos de instalación

Docker

Implementaciones en contenedores o sin interfaz gráfica.

Podman

Contenedor sin root: ejecute setup-podman.sh una vez y luego el script de inicio.

Nix

Instalación declarativa mediante Nix.

Ansible

Aprovisionamiento automatizado de flotas.

Bun

Uso solo de CLI mediante el runtime Bun.

Después de la instalación

Verifique que todo funciona:

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

Si necesita rutas de runtime personalizadas, use:

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

Consulte Variables de entorno para obtener precedencia y detalles completos.

Solución de problemas: no se encontró openclaw

Diagnóstico y solución de 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 su $PATH, su shell no puede encontrar los binarios globales de npm (incluido openclaw).

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

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

En Windows, añada 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

Actualización

Mantén OpenClaw actualizado.

Migración

Cambia a una nueva máquina.

Desinstalación

Elimina OpenClaw completamente.