Saltar al contenido principal

​
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.
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 nodo y modo MCP local.
curl -fsSL https://openclaw.ai/install.sh | bash
Para instalar sin ejecutar la incorporación: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
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@latest
openclaw onboard --install-daemon
El instalador alojado borra filtros de frescura de npm como min-release-age para la instalación del paquete OpenClaw. Si instalas manualmente con npm, tu propia política de npm sigue aplicándose.

​
Desde el código fuente

Para colaboradores 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 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

Docker

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

VPS

Elige un proveedor.

Docker VM

Pasos compartidos de Docker.

Kubernetes

Despliegue de K8s.

​
Actualizar, migrar o desinstalar

Actualización

Mantén OpenClaw actualizado.

Migración

Traslada a una máquina nueva.

Desinstalar

Elimina OpenClaw por completo.

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