Instalar

Requisitos del sistema

• Node 22.19+, 23.11+ o 24+ - Node 24 es el objetivo predeterminado; el script de instalación se encarga de esto automáticamente.
• macOS, Linux o Windows - Los usuarios de Windows pueden empezar con la aplicación nativa Windows Hub, el instalador de CLI para PowerShell o un Gateway WSL2. 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 marcas y opciones de CI/automatización, consulta Detalles internos del instalador.

Métodos de instalación alternativos

Instalador con prefijo local (install-cli.sh)

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

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

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

¿Ya está instalado? Cambia 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 gestionas Node tú mismo:

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

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

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

Desde el código fuente

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

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw 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 el checkout main de GitHub

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

Contenedores y gestores de paquetes

Verificar la instalación

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

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

• macOS: LaunchAgent mediante openclaw onboard --install-daemon u openclaw gateway install
• Linux/WSL2: servicio de usuario systemd mediante los mismos comandos
• Windows nativo: Scheduled Task primero, 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

Alojamiento y despliegue

Despliega OpenClaw en un servidor en la nube o VPS. Consulta Servidor Linux para ver el selector completo de proveedores (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi y más), o despliega de forma declarativa en Render.

Actualizar, migrar o desinstalar

Solución de problemas: no se encuentra openclaw

Casi siempre es un problema de PATH: el directorio bin global de npm no está en el PATH de tu shell. Consulta Solución de problemas de Node.js para ver la solución completa, incluida la ruta de Windows.

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