Instalar

Requisitos del sistema

• Node 24 (recomendado) o Node 22.19+ - el script de instalación lo gestiona 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 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 todas las opciones y las opciones de CI/automatización, consulta Detalles internos 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: Detalles internos del instalador.

¿Ya está instalado? Cambia entre instalaciones de paquete y de 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@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 contribuidores 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 puedes omitir el enlace y usar pnpm openclaw ... desde dentro del repositorio. Consulta Configuración para ver los flujos de trabajo de desarrollo completos.

Instalar desde el checkout de main en 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 administrado 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: primero Scheduled Task, con un elemento de inicio de sesión por usuario en la carpeta Startup como alternativa si se deniega la creación de la tarea

Alojamiento y despliegue

Despliega OpenClaw en un servidor en la nube o VPS:

Actualizar, migrar o desinstalar

Solución de problemas: no se encuentra openclaw

Si la instalación se completó correctamente pero no se encuentra openclaw en tu terminal:

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

Si $(npm prefix -g)/bin no está en tu $PATH, añádelo al archivo de inicio de tu shell (~/.zshrc o ~/.bashrc):

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

Luego abre una terminal nueva. Consulta Configuración de Node para obtener más detalles.