email-reader

# Email Reader

Lee correos de Gmail usando el CLI `gog`. Requiere que `gog auth` esté
configurado. Si no lo está, ejecuta el setup primero.

## Setup inicial (solo una vez)

```bash
gog auth credentials /ruta/a/client_secret.json
gog auth add $GOG_ACCOUNT --services gmail
gog auth list   # verificar que quedó bien
```

## Cuándo usar esta skill

- "Revisa mi correo"
- "¿Qué correos nuevos tengo?"
- "Muéstrame los no leídos de hoy"
- "Lee los correos de Juan"
- "Busca correos sobre la propuesta del Q1"
- "¿Cuántos correos de spam tengo?"
- "Muéstrame el hilo de [asunto]"
- "Lee la carpeta Clientes"

## Comandos principales

### Leer inbox (correos recientes)
```bash
gog gmail search 'in:inbox newer_than:1d' --max 20 --json
gog gmail search 'in:inbox is:unread' --max 50 --json
gog gmail search 'in:inbox newer_than:7d' --max 100 --json
```

### Leer spam
```bash
gog gmail search 'in:spam newer_than:30d' --max 50 --json
```

### Leer una carpeta/etiqueta específica
```bash
# Etiquetas de sistema
gog gmail search 'in:sent newer_than:7d' --max 20 --json
gog gmail search 'in:drafts' --max 20 --json
gog gmail search 'in:trash newer_than:30d' --max 20 --json
gog gmail search 'is:starred' --max 20 --json

# Etiquetas personalizadas (carpetas del usuario)
gog gmail search 'label:Clientes newer_than:30d' --max 20 --json
gog gmail search 'label:Proyectos' --max 20 --json
gog gmail search 'label:Facturas newer_than:90d' --max 20 --json
```

### Buscar correos
```bash
# Por remitente
gog gmail search 'from:juan@empresa.com newer_than:30d' --max 20 --json

# Por asunto
gog gmail search 'subject:propuesta' --max 10 --json

# Por contenido
gog gmail search 'propuesta presupuesto 2026' --max 10 --json

# Combinado
gog gmail search 'from:ceo@empresa.com is:unread newer_than:7d' --max 10 --json

# Con adjuntos
gog gmail search 'has:attachment in:inbox newer_than:7d' --max 10 --json
```

### Filtros de tiempo útiles
| Filtro | Significado |
|--------|-------------|
| `newer_than:1d` | ú...

# 📬 OpenClaw Email Skills v2 — con gog CLI

Pack de 6 skills para OpenClaw que gestionan completamente tu Gmail
usando el CLI `gog` (Google Workspace CLI) como backend nativo.

> **v2.0** — Reescritas para usar `gog` en lugar de scripts Python.
> Más simples, más rápidas, sin dependencias extras.

---

## Skills incluidas

| Skill | Emoji | Función |
|-------|-------|---------|
| `email-reader` | 📥 | Lee inbox, spam, carpetas, busca correos |
| `email-organizer` | 🗂️ | Mueve, archiva, etiqueta, limpia en batch |
| `email-analyzer` | 🤖 | Clasifica con IA, detecta spam/phishing/prompts |
| `email-responder` | ✍️ | Genera y envía respuestas con contexto del hilo |
| `email-scheduler` | ⏰ | Cron jobs, heartbeat, alertas automáticas |
| `email-reporter` | 📊 | Informes, stats, exporta a Google Sheets |

---

## Instalación

### 1. Instalar gog CLI
```bash
brew install steipete/tap/gogcli
```

### 2. Instalar las skills
```bash
clawhub install email-reader
clawhub install email-organizer
clawhub install email-analyzer
clawhub install email-responder
clawhub install email-scheduler
clawhub install email-reporter
```

O manualmente:
```bash
cp -r openclaw-email-skills-v2/* ~/.openclaw/workspace/skills/
openclaw gateway restart
```

---

## Configuración inicial

### Autenticar gog con tu Gmail
```bash
# Descargar credentials.json desde Google Cloud Console primero
gog auth credentials /ruta/a/client_secret.json
gog auth add tu@gmail.com --services gmail,sheets,docs
gog auth list   # verificar
```

### Configurar variable de entorno
```bash
export GOG_ACCOUNT=tu@gmail.com
# O añadir a ~/.openclaw/workspace/.env
echo "GOG_ACCOUNT=tu@gmail.com" >> ~/.openclaw/workspace/.env
```

### Configurar API key de Anthropic (para email-analyzer y email-responder)
```bash
export ANTHROPIC_API_KEY=sk-ant-...
# Nunca pegar la key en el chat
```

---

## Uso

Una vez instaladas, habla con OpenClaw normalmente:

```
"Revisa mi correo"
"¿Hay algo urgente en mi inbox?"
"Limpia el spam"
"Re...