Instalar

# Requisitos del sistema

• Node 24 (recomendado) o Node 22.14+; el script de instalación se encarga de esto automáticamente
• macOS, Linux o Windows; se admiten tanto Windows nativo como WSL2; WSL2 es más estable. Consulta Windows.
• pnpm solo es necesario si compilas desde el código fuente

# Recomendado: script de instalación

La forma más rápida de instalar. Detecta tu sistema operativo, instala Node si es necesario, instala OpenClaw e inicia la incorporación.

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

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

Para instalar sin ejecutar la incorporación:

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

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

Para todas las opciones y opciones de CI/automatización, consulta funcionamiento interno del instalador.

# Métodos de instalación alternativos

# Instalador con prefijo local (install-cli.sh)

Úsalo cuando quieras mantener OpenClaw y Node bajo un prefijo local como ~/.openclaw, sin depender de una instalación de Node para todo el sistema:

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

Admite instalaciones con npm de forma predeterminada, además de instalaciones desde un checkout de git bajo el mismo flujo de prefijo. Referencia completa: funcionamiento interno del instalador.

¿Ya está instalado? Alterna entre instalaciones de paquete y git con openclaw update --channel dev y openclaw update --channel stable. Consulta actualización.

# npm, pnpm o bun

Si ya administras Node por tu cuenta:

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

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun add -g openclaw@latest
openclaw onboard --install-daemon

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# Desde el código fuente

Para colaboradores o cualquier persona que quiera ejecutar desde un checkout local:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

O omite el enlace y usa pnpm openclaw ... desde dentro del repositorio. Consulta configuración para ver los flujos de trabajo completos de desarrollo.

# Instalar desde GitHub main

npm install -g github:openclaw/openclaw#main

# Contenedores y gestores de paquetes

# Verificar la instalación

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running

Si quieres un inicio administrado después de la instalación:

• macOS: LaunchAgent mediante openclaw onboard --install-daemon o openclaw gateway install
• Linux/WSL2: servicio de usuario systemd mediante los mismos comandos
• Windows nativo: primero Scheduled Task, con un elemento de inicio de sesión en la carpeta de inicio por usuario como alternativa si se deniega la creación de la tarea

# Hospedaje e implementación

Implementa OpenClaw en un servidor en la nube o VPS:

node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?

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