---
marp: true
theme: default
paginate: true
title: "Clase práctica: Instalación de OpenClaw"
---

# Clase práctica: Instalación de OpenClaw

- Objetivo: dejar OpenClaw funcionando de cero
- Enfoque: técnico, visual y paso a paso
- Resultado: Gateway activo + primer chat

Ayuda: explica que hoy no es teoría; es ejecución guiada.

---

# ¿Qué es OpenClaw?

- Gateway self-hosted para asistentes IA
- Conecta canales (Telegram, WhatsApp, Discord, etc.)
- Mantiene control local de configuración y sesiones

```mermaid
flowchart LR
A[Canales] --> B[Gateway OpenClaw]
B --> C[Agente IA]
B --> D[Control UI]
B --> E[CLI]
```

Ayuda: usa el diagrama para fijar el modelo mental.
Referencias: https://docs.openclaw.ai/

---

# Prerrequisitos mínimos

- Node.js 22 o superior
- Acceso a terminal (Linux/macOS/WSL)
- Conexión a internet y proveedor de modelo

```bash
node --version
npm --version
```

Ayuda: valida versiones antes de avanzar para evitar errores.
Referencias: https://docs.openclaw.ai/start/getting-started

---

# Instalación recomendada

- Script oficial para instalar OpenClaw
- Método rápido para entorno nuevo
- Luego verificar binario instalado

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

Ayuda: menciona que también existe instalación con npm/pnpm.
Referencias: https://docs.openclaw.ai/start/getting-started

---

# Onboarding inicial

- Ejecutar asistente de configuración
- Instalar daemon para ejecución continua
- Definir autenticación y ajustes base

```bash
openclaw onboard --install-daemon
```

Ayuda: pausa en cada pantalla del wizard y explica decisión.
Referencias: https://docs.openclaw.ai/start/wizard

---

# Verificación de salud del Gateway

- Confirmar runtime activo
- Revisar estado y logs
- Detectar problemas temprano

```bash
openclaw gateway status
openclaw status
openclaw logs --follow
```

Ayuda: muestra qué significa un estado saludable (RPC probe ok).
Referencias: https://docs.openclaw.ai/gateway/index

---

# Abrir el Dashboard

- Control visual para chat y configuración
- Acceso local por puerto del Gateway
- Útil para demo y soporte

```bash
openclaw dashboard
# o abrir http://127.0.0.1:18789/
```

Ayuda: enseña dónde están Config, sesiones y chat.
Referencias: https://docs.openclaw.ai/web/control-ui

---

# Configuración base segura

- Archivo: ~/.openclaw/openclaw.json
- Definir allowlist / dmPolicy
- Evitar exponer gateway sin auth

```json
{
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing"
    }
  }
}
```

Ayuda: enfatiza "pairing" como valor seguro inicial.
Referencias: https://docs.openclaw.ai/gateway/configuration | https://docs.openclaw.ai/gateway/security

---

# Flujo de primer mensaje

- Conectar canal elegido
- Enviar mensaje de prueba
- Verificar respuesta del agente

```bash
openclaw channels status --probe
openclaw message send --target "+595XXXXXXXX" --message "Hola OpenClaw"
```

Ayuda: si falla, ir a logs + doctor antes de tocar config.
Referencias: https://docs.openclaw.ai/channels

---

# Troubleshooting rápido

- Ejecutar doctor para diagnóstico guiado
- Revisar conflicto de puertos
- Validar token/auth si hay errores de conexión

```bash
openclaw doctor
openclaw gateway --port 18789 --verbose
```

Ayuda: muestra errores comunes y cómo leerlos sin pánico.
Referencias: https://docs.openclaw.ai/gateway/doctor | https://docs.openclaw.ai/gateway/troubleshooting

---

# Cierre y próximos pasos

- Ya tienes instalación operativa y verificable
- Siguiente: canales avanzados, skills y automatización
- Recomendación: documentar tu runbook interno

```mermaid
flowchart LR
A[Instalar] --> B[Onboard]
B --> C[Validar Health]
C --> D[Primer Chat]
D --> E[Escalar con Skills]
```

Ayuda: termina con checklist accionable y CTA técnico.
Referencias: https://docs.openclaw.ai/start/getting-started | https://clawhub.com