Instalación

Requisitos del sistema

Node 24 (recomendado) o Node 22.19+ - el script de instalación se encarga de esto automáticamente
macOS, Linux o Windows - se admiten tanto Windows nativo como WSL2; WSL2 es más estable. 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 su sistema operativo, instala Node si es necesario, instala OpenClaw e inicia el proceso de incorporación.

bash curl -fsSL https://openclaw.ai/install.sh | bash

powershell iwr -useb https://openclaw.ai/install.ps1 | iex

Para instalar sin ejecutar el proceso de incorporación:

bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Para ver todas las opciones de indicadores y CI/automatización, consulte Aspectos internos del instalador.

Métodos de instalación alternativos

Instalador de prefijo local (`install-cli.sh`)

Úselo cuando desee que OpenClaw y Node se mantengan en 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 mediante git-checkout bajo el mismo flujo de prefijo. Referencia completa: Aspectos internos del instalador.

¿Ya instalado? Cambie entre instalaciones de paquete y git con openclaw update --channel dev y openclaw update --channel stable. Consulte Actualización.

npm, pnpm o bun

Si ya administra Node usted mismo:

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun add -g openclaw@latest
openclaw onboard --install-daemon

Solución de problemas: errores de compilación de sharp (npm)

Si sharp falla debido a una libvips instalada globalmente:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Desde el código fuente

Para colaboradores o cualquier persona que desee ejecutar desde una copia 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 omita el enlace y use pnpm openclaw ... desde dentro del repositorio. Consulte Configuración para ver los flujos de trabajo de desarrollo completos.

Instalar desde GitHub main

npm install -g github:openclaw/openclaw#main

Contenedores y gestores de paquetes

Docker

Implementaciones en contenedores o sin interfaz gráfica.

Podman

Alternativa de contenedor sin root a Docker.

Nix

Instalación declarativa mediante Nix flake.

Ansible

Aprovisionamiento automatizado de flotas.

Bun

Uso exclusivo de CLI mediante el tiempo de ejecución de 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 desea un inicio administrado después de la instalación:

macOS: LaunchAgent a través de openclaw onboard --install-daemon o openclaw gateway install
Linux/WSL2: servicio de usuario de systemd mediante los mismos comandos
Windows nativo: Tarea programada primero, con un elemento de inicio de sesión de 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:

VPS

Cualquier VPS de Linux

Docker VM

Pasos compartidos de Docker

K8s

Google Cloud

Actualizar, migrar o desinstalar

Actualización

Mantén OpenClaw actualizado.

Migración

Mover a una nueva máquina.

Desinstalación

Elimina OpenClaw por completo.

Solución de problemas: `openclaw` no encontrado

Si la instalación se realizó correctamente pero openclaw no se encuentra en su 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 su $PATH, agréguelo a su archivo de inicio de shell (~/.zshrc o ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Luego abra una nueva terminal. Consulte Configuración de Node para obtener más detalles.