Referencia de Instalación
Guía completa que cubre todos los métodos de instalación incluyendo CLI, Docker y Desde Fuente.
¿Nuevo en OpenClaw?
Requisitos
- Runtime: Node.js ≥22 (npm, pnpm, o bun)
- Platforms: macOS, Linux, Windows (vía WSL2; fuertemente recomendado)
Instalación Recomendada (Asistente de Incorporación)
La configuración preferida es ejecutar el asistente de incorporación. Te guía a través de gateway, espacio de trabajo, canales y habilidades. El asistente CLI es la ruta recomendada y funciona en macOS, Linux y Windows (vía WSL2).
Comando de Instalación
npm install -g openclaw@latest # or: pnpm add -g openclaw@latest openclaw onboard --install-daemon
El asistente instala el demonio Gateway (servicio de usuario launchd/systemd) para que permanezca ejecutándose.
Inicio Rápido (TL;DR)
Comandos de Inicio Rápido
openclaw onboard --install-daemon openclaw gateway --port 18789 --verbose # Send a message openclaw message send --to +1234567890 --message "Hello from OpenClaw" # Talk to the assistant openclaw agent --message "Ship checklist" --thinking high
Instalación con Una Línea
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Funciona en macOS, Windows y Linux. La instalación con una línea instala Node.js y todo lo demás por ti.
Desde Fuente (Desarrollo)
Prefiere pnpm para compilaciones desde fuente. Bun es opcional para ejecutar TypeScript directamente.
Configuración de Desarrollo
git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build # auto-installs UI deps on first run pnpm build pnpm openclaw onboard --install-daemon # Dev loop (auto-reload on TS changes) pnpm gateway:watch
Nota
pnpm openclaw ... ejecuta TypeScript directamente (vía tsx). pnpm build produce dist/ para ejecutar vía Node / el binario openclaw empaquetado.Instalación Docker
OpenClaw soporta instalaciones basadas en Docker. Puedes ejecutar OpenClaw en un contenedor Docker para ejecución aislada.
La instalación Docker es particularmente útil para:
- Ejecutar OpenClaw en servidores o instancias en la nube
- Entornos de ejecución aislados
- Despliegue y escalado fácil
- Unraid y otras plataformas de contenedores
Instalación Rápida Docker:
docker run -d --name openclaw \ -v ~/.openclaw:/root/.openclaw \ -p 18789:18789 \ ghcr.io/openclaw/openclaw:latest
Para instrucciones detalladas de configuración Docker, ejemplos de Docker Compose y configuración Unraid, consulta la guía de despliegue Docker.
Despliegue Serverless (OpenClaw Worker)
Para usuarios que prefieren no gestionar hardware o servidores, OpenClaw Worker te permite ejecutar OpenClaw en Cloudflare Workers sin ninguna infraestructura física.
Moltworker es ideal para:
- Ejecutar agentes de IA sin requisitos de hardware
- Arquitectura serverless y escalado automático
- Modelo de precios de pago por uso
- Distribución global en el borde para baja latencia
Aprende más sobre desplegar OpenClaw con OpenClaw Worker en Cloudflare Workers.
Canales de Desarrollo
OpenClaw ofrece diferentes canales de lanzamiento:
- Stable: Versiones etiquetadas (vYYYY.M.D), npm dist-tag latest.
- Beta: Etiquetas de pre-lanzamiento, npm dist-tag beta (la app macOS puede faltar).
- Dev: Cabeza móvil de main, npm dist-tag dev (cuando se publica).
Cambiar canales:
Nota
openclaw. Asegúrate de usar la última versión para acceder a todas las funciones.Actualizando
Para actualizar OpenClaw a la última versión:
Comando de Actualización
openclaw update
Después de actualizar, ejecuta openclaw doctor para verificar problemas y validar tu configuración.