Skip to main content

​
Instalar

¿Ya siguió Primeros pasos? Todo listo — esta página es para métodos de instalación alternativos, instrucciones específicas por plataforma y mantenimiento.

​
Requisitos del sistema

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. Gestiona la detección de Node, la instalación y el onboarding en un solo paso.

Installer script

Descarga la CLI, la instala globalmente mediante npm y lanza el asistente de onboarding.
Eso es todo — el script gestiona la detección de Node, la instalación y el onboarding.Para omitir el onboarding e instalar solo el binario:
Para todas las flags, variables de entorno y opciones de CI/automatización, consulte Internos del instalador.
Si ya tiene Node 22+ y prefiere gestionar la instalación usted mismo:
Si tiene libvips instalado globalmente (común en macOS vía Homebrew) y sharp falla, fuerce los binarios precompilados:
Si ve sharp: Please add node-gyp to your dependencies, instale las herramientas de compilación (macOS: Xcode CLT + npm install -g node-gyp) o use la variable de entorno anterior.
Para colaboradores o cualquiera que quiera ejecutar desde un checkout local.
1

Clonar y compilar

Clone el repositorio de OpenClaw y compile:
2

Vincular la CLI

Haga que el comando openclaw esté disponible globalmente:
Alternativamente, omita el vínculo y ejecute los comandos mediante pnpm openclaw ... desde dentro del repositorio.
3

Ejecutar onboarding

Para flujos de trabajo de desarrollo más profundos, consulte Configuración.

​
Otros métodos de instalación

Docker

Implementaciones en contenedores o sin interfaz.

Podman

Contenedor sin privilegios: ejecute setup-podman.sh una vez, luego el script de lanzamiento.

Nix

Instalación declarativa mediante Nix.

Ansible

Aprovisionamiento automatizado de flotas.

Bun

Uso solo de la CLI mediante el runtime Bun.

​
Después de instalar

Verifique que todo esté funcionando:
Si necesitas rutas de ejecución personalizadas, utiliza:
  • OPENCLAW_HOME para rutas internas basadas en el directorio home
  • OPENCLAW_STATE_DIR para la ubicación del estado mutable
  • OPENCLAW_CONFIG_PATH para la ubicación del archivo de configuración
Consulta Environment vars para conocer la precedencia y todos los detalles.

​
Solución de problemas: openclaw no encontrado

Diagnóstico rápido:
Si $(npm prefix -g)/bin (macOS/Linux) o $(npm prefix -g) (Windows) no está en su $PATH, su shell no puede encontrar los binarios globales de npm (incluido openclaw).Corrección — agréguelo a su archivo de inicio del shell (~/.zshrc o ~/.bashrc):
En Windows, agregue la salida de npm prefix -g a su PATH.Luego abra una nueva terminal (o ejecute rehash en zsh / hash -r en bash).

​
Actualizar / desinstalar

Updating

Mantenga OpenClaw actualizado.

Migrating

Muévase a una nueva máquina.

Uninstall

Elimine OpenClaw por completo.