Skip to main content

​
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.
Quienes usen el escritorio de Windows también pueden instalar la aplicación complementaria nativa Windows Hub, que incluye configuración, estado en la bandeja del sistema, chat, modo Node y modo MCP local.
Para instalar sin ejecutar la configuración inicial:
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:
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:
El instalador alojado elimina los filtros de actualización de npm, como min-release-age, para la instalación del paquete OpenClaw. Si realiza la instalación manualmente con npm, seguirá aplicándose su propia política de npm.

​
Desde el código fuente

Para colaboradores o cualquier persona que desee ejecutar OpenClaw desde un checkout local:
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

​
Contenedores y gestores de paquetes

Docker

Despliegues en contenedores o sin interfaz gráfica.

Podman

Alternativa a Docker con contenedores sin privilegios de administrador.

Nix

Instalación declarativa mediante un flake de Nix.

Ansible

Aprovisionamiento automatizado de flotas.

Bun

Instalador de dependencias y ejecutor de scripts de paquetes opcional.

​
Verificación de la instalació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.

VPS

Elija un proveedor.

Máquina virtual con Docker

Pasos compartidos de Docker.

Kubernetes

Despliegue de K8s.

​
Actualización, migración o desinstalación

Actualización

Mantenga OpenClaw actualizado.

Migración

Traslade OpenClaw a una máquina nueva.

Desinstalación

Elimine OpenClaw por completo.

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