Instalar

Requisitos del sistema

• Node 22.22.3+, 24.15+ o 25.9+ - Node 24 es la versión de destino predeterminada; el script de instalación se encarga de esto automáticamente.
• macOS, Linux o Windows - Los usuarios de Windows pueden comenzar con la aplicación nativa Windows Hub, el instalador de la CLI para PowerShell o un Gateway en WSL2. Consulte Windows.
• pnpm solo es necesario si se compila desde el código fuente.

Recomendado: script de instalación

La forma más rápida de realizar la instalación. Detecta el sistema operativo, instala Node si es necesario, instala OpenClaw e inicia la configuración inicial.

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

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

Para instalar sin ejecutar la configuración inicial:

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

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

Para consultar todas las opciones y las alternativas para CI y automatización, consulte Funcionamiento interno del instalador.

Métodos de instalación alternativos

Instalador con prefijo local (install-cli.sh)

Utilice esta opción cuando quiera 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

De forma predeterminada, admite instalaciones mediante npm, además de instalaciones desde un repositorio git bajo el mismo flujo de prefijo. Referencia completa: Funcionamiento interno del instalador.

¿Ya está instalado? Cambie entre instalaciones de paquete y git con openclaw update --channel dev y openclaw update --channel stable. Consulte Actualización.

npm, pnpm o bun

Si ya gestiona Node por su cuenta:

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 cualquier persona que quiera ejecutar OpenClaw desde una copia local del repositorio:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

También se puede omitir el enlace y utilizar pnpm openclaw ... desde el repositorio. Consulte Configuración para conocer los flujos de trabajo de desarrollo completos.

Instalación desde la rama 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      # confirmar que la CLI está disponibleopenclaw doctor         # comprobar si hay problemas de configuraciónopenclaw gateway status # verificar que el Gateway esté en ejecución

Si se desea 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 de systemd mediante los mismos comandos
• Windows nativo: primero se utiliza una tarea programada, con un elemento de inicio de sesión por usuario en la carpeta Inicio como alternativa si se deniega la creación de la tarea

Alojamiento e implementación

Implemente OpenClaw en un servidor en la nube o VPS. Consulte Servidor Linux para acceder al selector completo de proveedores (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi y más), o impleméntelo de forma declarativa en Render.

Actualizar, migrar o desinstalar

Solución de problemas: no se encuentra openclaw

Casi siempre se trata de un problema con PATH: el directorio global de binarios de npm no está incluido en el PATH del shell. Consulte Solución de problemas de Node.js para conocer la solución completa, incluida la ruta de Windows.

node -v           # ¿Está instalado Node?npm prefix -g     # ¿Dónde están los paquetes globales?echo "$PATH"      # ¿Está el directorio global de binarios en PATH?