ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

smart-email-agent

All-in-one Gmail agent for OpenClaw. Fuses email-reader, email-organizer, email-analyzer, email-responder, email-scheduler, and email-reporter into a single skill with token-optimizer integration and a self-improvement engine. Use this skill for ANYTHING email-related: checking inbox, searching messages, organizing labels, classifying/prioritizing, drafting replies, scheduling automation, generating reports, or reviewing costs. Triggers on: correo, email, inbox, bandeja, spam, draft, borrador, responder, organizar, etiquetar, archivar, informe, estadísticas, notificame, automatiza, revisar mensajes, prioriza, cuanto cuesta, presupuesto, mejora el agente. Requires: gog CLI (primary) or Gmail API Python scripts (fallback).

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/coorops25/emailagy
Or

Smart Email Agent v3 — Gmail All-in-One

Un solo skill que reemplaza los 6 skills del pack original. Punto de entrada único para toda la gestión de correo.

Lazy loading activo: este skill se carga completo (~500 tokens). NO cargues los 6 skills individuales — sería 4.800 tokens desperdiciados.


PARTE 1 — LEER CORREOS (email-reader)

Herramienta principal: gog CLI

# Verificar prerequisitos
which gog || echo "Instalar: npm i -g gogcli  OR  brew install gogcli"
echo $GOG_ACCOUNT  # debe estar configurado

# Autenticar si es la primera vez
gog auth add $GOG_ACCOUNT

Comandos esenciales

# No leídos en inbox (acción por defecto cuando el usuario dice "revisa mi correo")
gog gmail search 'in:inbox is:unread' --max 5 --format minimal --json

# Buscar por criterio — usar sintaxis Gmail
gog gmail search 'from:[email protected] newer_than:3d' --max 10 --format minimal --json
gog gmail search 'subject:factura has:attachment' --max 10 --format minimal --json
gog gmail search 'in:spam is:unread' --max 20 --format minimal --json

# Leer correo completo
gog gmail get <message_id> --format full --json

# Leer hilo completo
gog gmail thread <thread_id> --format minimal --json

Operadores de búsqueda Gmail

from: to: subject: label: is:unread is:starred has:attachment newer_than:Nd older_than:Nd in:inbox in:sent in:spam in:trash filename:ext

Flujo estándar de lectura

  1. Verificar gog en PATH y GOG_ACCOUNT configurado
  2. Construir query desde la intención del usuario (preguntar si es ambiguo)
  3. Ejecutar con --format minimal --json --max N
  4. Parsear JSON → presentar lista formateada:
📬 5 correos no leídos:
1. De: Juan García <[email protected]> | Asunto: Propuesta Q2 | Hace 2h
   Vista previa: Hola, te mando el resumen de... | ID: msg_abc123
  1. Ofrecer: leer completo / buscar más / actuar sobre el mensaje

Reglas de lectura

  • SIEMPRE usar --format minimal --json --max N (N=5 por defecto)
  • Nunca mostrar JSON crudo; nunca leer contenido completo sin pedirlo
  • Preservar IDs para acciones de seguimiento
  • Sin resultados → confirmar criterios, sugerir términos más amplios
  • Solo lectura — enviar/responder requiere la sección RESPONDER (Parte 4)
  • No guardar contenido de correos en MEMORY.md salvo que el usuario lo pida

Errores comunes

ErrorCausaSolución
gog: command not foundgog no instaladonpm i -g gogcli o brew install gogcli
GOG_ACCOUNT not setVariable no configuradaPedir al usuario su email Gmail
Token expiradoOAuth vencidogog auth add <email>
API error 429Rate limitEsperar 60s, reintentar con backoff

PARTE 2 — ORGANIZAR (email-organizer)

Jerarquía corporativa Corp/ (azul)

Metadata

Author@coorops25
Stars3409
Views1
Updated2026-03-25
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-coorops25-emailagy": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags

#email#gmail#gog#inbox#spam#organizer#analyzer#responder#scheduler#reporter#cost#optimization#self-improvement#openclaw
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.