English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Instalar

Edit source

Requisitos del sistema

  • Node 24 (recomendado) o Node 22.16+ - 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. Consulta Windows.
  • pnpm solo es necesario si compilas desde el código fuente

Recomendado: script de instalación

La forma más rápida de instalar. Detecta tu sistema operativo, instala Node si es necesario, instala OpenClaw e inicia la incorporación.

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Para instalar sin ejecutar la incorporación:

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Para ver todas las marcas y opciones de CI/automatización, consulta Detalles internos del instalador.

Métodos de instalación alternativos

Instalador de prefijo local (install-cli.sh)

Usa esto cuando quieras mantener OpenClaw y Node bajo un prefijo local como ~/.openclaw, sin depender de una instalación de Node de todo el sistema:

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

Admite instalaciones con npm de forma predeterminada, además de instalaciones desde git checkout bajo el mismo flujo de prefijo. Referencia completa: Detalles internos del instalador.

¿Ya está instalado? Cambia entre instalaciones de paquete y de git con openclaw update --channel dev y openclaw update --channel stable. Consulta Actualizar.

npm, pnpm o bun

Si ya administras Node por tu cuenta:

npm

bash
npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm

bash
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun

bash
bun add -g openclaw@latestopenclaw onboard --install-daemon
Troubleshooting: sharp build errors (npm)

Si sharp falla debido a una libvips instalada globalmente:

bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Desde el código fuente

Para colaboradores o cualquier persona que quiera ejecutar desde un checkout local:

bash
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

O salta el enlace y usa pnpm openclaw ... desde dentro del repositorio. Consulta Configuración para ver los flujos de trabajo de desarrollo completos.

Instalar desde GitHub main

bash
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 solo de CLI mediante el entorno de ejecución Bun.

Verificar la instalación

bash
openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

Si quieres un inicio gestionado después de la instalación:

  • macOS: LaunchAgent mediante openclaw onboard --install-daemon u openclaw gateway install
  • Linux/WSL2: servicio de usuario systemd mediante los mismos comandos
  • Windows nativo: primero Scheduled Task, con un elemento de inicio de sesión por usuario en la carpeta Startup como alternativa si se deniega la creación de la tarea

Alojamiento e implementación

Implementa OpenClaw en un servidor en la nube o VPS:

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9lcy9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

Actualizar, migrar o desinstalar

Updating

Mantén OpenClaw actualizado.
Migrating

Traslada a una máquina nueva.
Uninstall

Elimina OpenClaw por completo.

Solución de problemas: openclaw no encontrado

Si la instalación se realizó correctamente pero openclaw no se encuentra en tu terminal:

bash
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 al archivo de inicio de tu shell (~/.zshrc o ~/.bashrc):

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

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

Was this useful?