Saltar al contenido principal

​
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.
Los usuarios de escritorio de Windows también pueden instalar la aplicación complementaria nativa Windows Hub, que incluye configuración, estado en la bandeja, chat, modo de nodo y modo MCP local.
curl -fsSL https://openclaw.ai/install.sh | bash
Para instalar sin ejecutar la configuración inicial: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
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@latest
openclaw onboard --install-daemon
El instalador alojado desactiva filtros de frescura de npm como min-release-age para la instalación del paquete OpenClaw. Si instalas manualmente con npm, se sigue aplicando tu propia política de npm.

​
Desde el código fuente

Para contribuidores o cualquiera 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 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

Docker

Despliegues en contenedores o sin interfaz gráfica.

Podman

Alternativa de contenedores sin root a Docker.

Nix

Instalación declarativa mediante Nix flake.

Ansible

Aprovisionamiento automatizado de flotas.

Bun

Uso solo de CLI mediante el runtime Bun.

​
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 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:

VPS

Cualquier VPS Linux.

Docker VM

Pasos compartidos de Docker.

Kubernetes

Despliegue en K8s.

Fly.io

Despliega en Fly.io.

Hetzner

Despliegue en Hetzner.

GCP

Despliegue en Google Cloud.

Azure

Despliegue en Azure.

Railway

Despliegue en Railway.

Render

Despliegue en Render.

Northflank

Despliegue en Northflank.

​
Actualizar, migrar o desinstalar

Updating

Mantén OpenClaw actualizado.

Migrating

Traslada a una máquina nueva.

Uninstall

Elimina OpenClaw por completo.

​
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.