Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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. 
curl -fsSL https://openclaw.ai/install.sh | bash
Para instalar sin ejecutar la incorporación: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
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: 
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 install -g openclaw@latest
openclaw onboard --install-daemon
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 quiera ejecutar desde un checkout 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 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

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

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw 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

Cualquier VPS Linux

Docker VM

Pasos compartidos de Docker

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

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: 
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): 
export PATH="$(npm prefix -g)/bin:$PATH"
Luego abre una terminal nueva. Consulta Configuración de Node para obtener más detalles.