Instalar
¿Ya seguiste Primeros pasos? Ya estás listo — esta página es para métodos de instalación alternativos, instrucciones específicas de plataforma y mantenimiento.
Requisitos del sistema
- Node 22+ (el script de instalación lo instalará si falta)
- macOS, Linux o Windows
pnpmsolo si compilas desde el código fuente
ℹ️ En Windows, recomendamos encarecidamente ejecutar OpenClaw bajo WSL2.
Métodos de instalación
💡 El script de instalación es la forma recomendada de instalar OpenClaw. Maneja la detección de Node, la instalación y la configuración inicial en un solo paso.
⚠️ Para hosts VPS/en la nube, evita las imágenes de marketplace de terceros "con un clic" cuando sea posible. Prefiere una imagen base limpia del sistema operativo (por ejemplo, Ubuntu LTS), luego instala OpenClaw tú mismo con el script de instalación.
Otros métodos de instalación
Docker
Implementaciones en contenedores o sin interfaz gráfica.
Podman
Contenedor sin privilegios de root: ejecuta setup-podman.sh una vez, luego el script de lanzamiento.
Nix
Instalación declarativa vía Nix.
Ansible
Aprovisionamiento automatizado de flotas.
Bun
Uso solo de CLI mediante el entorno de ejecución Bun.
Después de la instalación
Verifica que todo funcione:
openclaw doctor # comprobar problemas de configuración
openclaw status # estado del gateway
openclaw dashboard # abrir la interfaz de usuario en el navegador
Si necesitas rutas de ejecución personalizadas, usa:
OPENCLAW_HOMEpara rutas internas basadas en el directorio de inicioOPENCLAW_STATE_DIRpara la ubicación del estado mutableOPENCLAW_CONFIG_PATHpara la ubicación del archivo de configuración
Consulta Variables de entorno para el orden de precedencia y detalles completos.