Instalar

Requisitos del sistema

• Node 22.22.3+, 24.15+ o 25.9+: Node 24 es el objetivo predeterminado; el script de instalación se encarga de ello automáticamente.
• macOS, Linux o Windows: quienes usen 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 compila desde el código fuente.

Recomendado: script de instalación

La forma más rápida de instalar. 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 de CI/automatización, consulte Detalles internos del instalador.

Métodos de instalación alternativos

Instalador con prefijo local (install-cli.sh)

Utilice esta opción si desea 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 mediante npm de forma predeterminada, además de instalaciones desde un checkout de git con el mismo flujo de prefijo. Referencia completa: Detalles internos del instalador.

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

npm, pnpm o bun

Si ya administra 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 desee ejecutar OpenClaw desde un checkout local:

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

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

Instalación desde el checkout de 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

Verificación de 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 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 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 y despliegue

Despliegue 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 otros), o realice un despliegue declarativo en Render.

Actualización, migración o desinstalación

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 la variable PATH del shell. Consulte Solución de problemas de Node.js para ver 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?