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 todas las opciones de banderas y automatización de CI, consulte Aspectos internos del instalador.

Métodos de instalación alternativos

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

Use esto cuando desee que OpenClaw y Node se mantengan 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 npm de forma predeterminada, además de instalaciones de 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

Desde la fuente

Para colaboradores o cualquiera 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 completos de desarrollo.

Instalar desde la rama principal 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 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 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 systemd mediante los mismos comandos
Windows nativo: Tarea programada primero, con una alternativa de elemento de inicio de sesión en la carpeta de Inicio por usuario si se deniega la creación de la tarea

Alojamiento e implementación

Implemente OpenClaw en un servidor en la nube o VPS:

VPS

Cualquier VPS de Linux.

Docker VM

Pasos compartidos de Docker.

Kubernetes

Despliegue en K8s.

Fly.io

Despliegue en Fly.io.

Hetzner

Despliegue en Hetzner.

GCP

Despliegue en Google Cloud.

Azure

Despliegue en Azure.

Railway

Despliegue en Railway.

Render

Despliegue en Render.

Northflank

Despliegue en Northflank.

Actualizar, migrar o desinstalar

Updating

Mantén OpenClaw actualizado.

Migrating

Mover a una nueva máquina.

Uninstall

Eliminar OpenClaw completamente.

Solución de problemas: `openclaw` no encontrado

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

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

Luego, abre una nueva terminal. Consulta Configuración de Node para más detalles.