Instalación +
el sistema "partner"

Dónde venís

En la Clase 01 entendiste qué es OpenClaw y por qué importa. Dijiste "lo quiero". Bien: ahora lo ponemos a vivir.

Cuatro caminos: dónde va a vivir tu agente

Lo primero que elegís es en qué máquina vive tu agente. OpenClaw necesita una computadora prendida 24/7 (su "corazón" late aunque vos no estés mirando). Lo bueno: después de elegir dónde, todo lo demás —modelos, canales, identidad— funciona igual. Hay cuatro opciones, y te recomendamos la primera.

Elijas lo que elijas, el resto de la instalación es igual. Y si vas por el VPS, la seguridad no es opcional: su SSH y su Gateway quedan en internet (los bots escanean 24/7), así que lo cerrás con Tailscale + token como vemos en la Clase 10.

Instalación: el comando oficial (para A, B y C)

Si elegiste el camino D (gestionado), salteá esto: no hay nada que instalar — andá directo a su paso a paso, más abajo. Para los otros tres, instalar es casi idéntico. La documentación oficial ofrece un instalador de un solo comando que detecta tu sistema, instala Node.js si falta, instala OpenClaw y lanza el asistente. Lo único que cambia es cómo llegás a la terminal de esa máquina (y, en el VPS, si lo corrés directo o dentro de Docker).

Paso común — el instalador de un comando

# macOS / Linux  (incluye tu VPS con Ubuntu)
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex

# Después: lanzá el onboarding e instalá el daemon (servicio 24/7)
openclaw onboard --install-daemon

Ese script instala Node.js (24, o 22.14+) si te falta, instala OpenClaw global, y deja el daemon como servicio del sistema (launchd en macOS, systemd en Linux) para que reviva solo al reiniciar. Si preferís control paso a paso:

npm install -g openclaw@latest      # también: pnpm add -g openclaw@latest
openclaw onboard --install-daemon   # onboarding + daemon
openclaw --version                  # verificar versión
openclaw doctor                     # diagnóstico del entorno
openclaw gateway status             # ver que el Gateway escuche (:18789)

🟢 En un VPS (recomendado), paso a paso

1. Creá un VPS con Ubuntu 22.04+ (DigitalOcean, Hetzner, Vultr). Con 2 vCPU y 2–4 GB de RAM alcanza para empezar.
2. Conectate por SSH: ssh root@TU_IP.
3. Corré el instalador de un comando de arriba y, al terminar, openclaw onboard --install-daemon.
4. Cerralo antes de usarlo: instalá Tailscale y dejá el Gateway en loopback + token. Nunca lo dejes abierto a internet (Clase 10).

docker run -d --name openclaw --restart unless-stopped \
  -e OPENCLAW_GATEWAY_TOKEN=$OPENCLAW_GATEWAY_TOKEN \
  -v /home/openclaw/.openclaw:/home/node/.openclaw \
  -p 18789:18789 \
  ghcr.io/openclaw/openclaw:latest

# Correr el asistente dentro del contenedor
docker exec -it openclaw openclaw onboard

🖥️ En un ordenador físico secundario, paso a paso

1. En la compu secundaria, abrí la terminal:
   • macOS: si no tenés Homebrew, instalalo primero (el one-liner igual instala Node solo):
     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   • Windows: abrí PowerShell como administrador.
   • Linux: la terminal normal.
2. Corré el instalador de un comando que corresponda a tu sistema (los de arriba).
3. openclaw onboard --install-daemon para que arranque solo cada vez que prendas la máquina.
4. En los ajustes de energía, desactivá la suspensión para que quede prendida 24/7.

🧪 En una máquina virtual con VirtualBox, paso a paso

Este camino no requiere comprar nada: bajás VirtualBox, bajás un Ubuntu Server ya listo para VirtualBox (no hace falta "instalar" Linux: viene armado adentro de un disco virtual) y la usás como un mini-servidor: entrás por SSH desde tu terminal y la arrancás sin ventana (headless).

Parte 1 — Preparación del entorno (tres descargas y un descomprimir, nada más):

1. VirtualBox — el software de virtualización: virtualbox.org (gratis; Windows, macOS y Linux).
2. Ubuntu Server 24.04 — disco virtual pre-configurado: osboxes.org/ubuntu-server, pestaña VirtualBox (64bit).
3. 7-Zip (7-zip.org) para descomprimir el .7z descargado → te queda un archivo .vdi con el sistema operativo listo para usar.

Parte 2 — Configurar VirtualBox:

1. Nueva máquina virtual: abrí VirtualBox → Nueva → nombre openclaw, tipo Linux, versión Ubuntu (64-bit), con 2 GB de RAM y 2 CPUs (si tu compu tiene 16 GB o más, ponele 4 GB para mejor rendimiento).
2. Agregá el disco .vdi: en la sección de disco duro, seleccioná "Usar un archivo de disco duro virtual existente" y elegí el .vdi que descomprimiste.
3. Configurá la red: antes de iniciar la máquina, andá a Configuración → Red y cambiá de "NAT" a "Adaptador puente" (Bridge Adapter). Así la VM tiene su propia IP en tu red local — la clave para entrarle por SSH.

Parte 3 — Configurar Ubuntu Server y entrar por SSH:

1. Iniciá la máquina. Vas a ver una pantalla negra pidiendo login: usuario osboxes, contraseña osboxes.org. Cambiala sí o sí con el comando passwd:
   terminal · dentro de la VMCopiar

   passwd   # presioná Enter
   Current password: osboxes.org
   New password: TU_NUEVA_CLAVE
   Retype new password: TU_NUEVA_CLAVE

2. Obtené la IP de la máquina: corré ip a y buscá el número con formato 192.168.x.x al lado de "inet". Anotalo.
3. Actualizá el sistema e instalá SSH: esto te permite conectarte desde Windows/Mac sin usar la ventana de VirtualBox.
   terminal · dentro de la VMCopiar

   sudo apt update
   sudo apt upgrade -y
   sudo apt install openssh-server -y
   sudo systemctl enable --now ssh

4. Conectate desde tu compu (CMD o Terminal): ssh osboxes@192.168.x.xx. La primera vez SSH te pregunta si confiás en esa máquina — escribí yes (tu fingerprint va a ser distinto). Se ve así:
   CMD / Terminal · primera conexiónCopiar

   ssh osboxes@192.168.x.xx
   The authenticity of host '192.168.x.xx (192.168.x.xx)' can't be established.
   ED25519 key fingerprint is SHA256:ndxaZMWD2t9l6QY56d5xRzEEBpnd3rRBCdMBxIbZXlg.
   This host key is known by the following other names/addresses:
       C:\Users\(tu_usuario)/.ssh/known_hosts:4: 192.168.x.xx (la IP de tu máquina virtual)
   Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
   Warning: Permanently added '192.168.x.xx' (ED25519) to the list of known hosts.
   osboxes@192.168.x.xx's password:

   Desde ahora trabajás cómodo desde tu terminal favorita, sin la ventana de VirtualBox.
5. Instalá OpenClaw por SSH: ya conectado, corré el instalador oficial y el onboarding:
   terminal · por SSH, dentro de la VMCopiar

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

⚡ Arrancarla sin ventana (headless), con un acceso directo

Con el SSH funcionando, la interfaz gráfica sobra. VirtualBox te crea el acceso directo solo — solamente hay que agregarle una opción:

1. En el administrador de VirtualBox, click derecho sobre el ícono de tu máquina virtual → Crear acceso directo en el escritorio.
2. En el Escritorio, click derecho sobre ese acceso directo → Propiedades → al final del campo Destino, agregale --type headless (con un espacio antes de --) → Aceptar.
3. Doble click → la máquina arranca invisible, sin ventana. Esperá ~30 segundos (Ubuntu tiene que bootear) y entrá con ssh osboxes@TU_IP.
4. ¿Querés confirmar que está corriendo? En CMD: "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" list runningvms — si tu VM aparece en la lista, está viva. (También la ves como "Corriendo" en el administrador de VirtualBox.)
5. Para apagarla sin ventana: "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" controlvm "openclaw" acpipowerbutton.

🦞 Con Abacus Claw (gestionado en la nube), paso a paso

Acá no se instala nada: Abacus corre OpenClaw por vos en su infraestructura (Abacus Claw), siempre encendido, y lo manejás desde el navegador. (Info vigente a junio 2026.)

1. Suscribite en abacus.ai. Hay dos planes que incluyen Claw: el de Personal Agents (USD 7 el primer mes, después ~USD 10/mes) y el ChatLLM Teams Pro de USD 20/mes, que suma 30.000 créditos mensuales y la suite completa de ChatLLM.
2. Entrá a claw.abacus.ai con tu cuenta y creá una sesión nueva: tu claw ya está corriendo, sin servidor ni terminal.
3. Configuralo hablándole en lenguaje natural — todo lo que aprendés en este curso (identidad, memoria, skills) aplica igual.
4. Conectá tus canales (los mismos que el resto: Telegram, WhatsApp, Slack y demás): Telegram (token de @BotFather + allowFrom), WhatsApp (dmPolicy/groupPolicy) o Slack (Socket Mode con app token).
5. Opcional — BYOK: traé tu propia API key de Anthropic, OpenAI o Google para pagar los tokens directo al proveedor.

El onboarding (en A, B y C)

Cuando termina la instalación arranca el asistente, que te lleva por tres pasos:

Arrancá con el BOOTSTRAP (no te lo saltees)

OpenClaw trae un archivo BOOTSTRAP.md que corre en tu primera conversación y te guía para ponerle nombre al agente y armar su identidad. El problema: si tu primer mensaje es una pregunta real ("che, mirá mi calendario"), el agente prioriza responder eso y el bootstrap nunca corre. Te quedás con la identidad en blanco por una semana.

Mandá eso primero, antes de pedirle cualquier otra cosa. Cinco minutos y tu agente sabe quién es y quién sos desde el día uno.

El sistema "partner": tu seguro anti-trabas

Una garantía: las cosas se van a romper. El agente va a crashear, perder contexto, tirar errores. Le pasa a todos (OpenClaw, Claude Code, Codex). La habilidad que te enseña esta clase no es evitar que se rompa, sino nunca quedarte trabado.

No necesitás entender el detalle técnico. Necesitás saber este ida y vuelta. Es, según el curso, la habilidad más importante de todas.