Skill PhishGuard#

Que hace este skill#

Este skill monitorea automaticamente las bandejas de entrada en busca de ataques de phishing. Se ejecuta en segundo plano y revisa los correos nuevos en un intervalo configurable.

Cuando llega un correo nuevo, PhishGuard:

1. Extrae remitente, asunto, cuerpo, URLs y cabeceras de autenticacion (SPF/DKIM)
2. Ejecuta verificaciones de reglas estaticas (typosquatting, palabras de urgencia, URLs sospechosas, fallas de autenticacion)
3. Envia el correo a la API de Claude para un analisis semantico de phishing
4. Combina ambos puntajes en un nivel de riesgo final: BAJO / MEDIO / ALTO / CRITICO
5. Toma la accion correspondiente segun el nivel de riesgo

Niveles de riesgo y acciones#

Nivel de riesgoPuntajeAccion tomadaBAJO0-24Entrega normal, sin accionMEDIO25-49Agrega etiqueta de advertencia al correoALTO50-74Cuarentena + alerta al usuario + notificacion a Slack/TeamsCRITICO75-100Cuarentena + alerta al usuario + notificacion a Slack/Teams + registro

Como invocar este skill#

Podes pedirle a OpenClawd que ejecute PhishGuard de las siguientes formas:

• "Inicia el monitoreo de phishing"
• "Revisa mi bandeja en busca de phishing"
• "Analiza este correo: [pegar correo]"
• "Mostrame el reporte de PhishGuard de hoy"
• "Detene el monitoreo de PhishGuard"

Como funciona internamente#

El skill esta implementado en phishguard.js. Expone estas funciones principales:

• startMonitoring(context) — inicia el ciclo de revision de correos en segundo plano
• stopMonitoring(context) — detiene el ciclo de revision
• analyzeEmail(emailData, context) — analiza un correo individual bajo demanda
• getReport(context) — devuelve un resumen de las detecciones de la sesion actual

Cuando el monitoreo esta activo, el skill consulta Gmail cada N segundos (por defecto: 60) usando la herramienta de Gmail disponible en OpenClawd. Por cada correo no leido que no haya visto antes, ejecuta analyzeEmail() y actua segun el resultado.

Herramientas de OpenClawd requeridas#

Este skill utiliza las siguientes herramientas que deben estar habilitadas en tu instancia de OpenClawd:

• gmail:list-messages — listar mensajes no leidos
• gmail:get-message — obtener el contenido completo y cabeceras del mensaje
• gmail:modify-message — agregar etiquetas (cuarentena, advertencia)
• slack:send-message O teams:send-message — enviar notificaciones de alerta (opcional)

Variables de entorno#

VariableRequeridaPor defectoDescripcionANTHROPIC_API_KEYSi—API key de Claude para el analisis de IASLACK_WEBHOOK_URLNo—Webhook de Slack para alertasTEAMS_WEBHOOK_URLNo—Webhook de Teams para alertasGMAIL_CHECK_INTERVAL_SECONDSNo60Frecuencia de revision de Gmail en segundosPHISHGUARD_QUARANTINE_LABELNoPhishGuard-CuarentenaEtiqueta de Gmail para correos en cuarentena

Formato de salida#

Cuando se analiza un correo, PhishGuard reporta lo siguiente:

text

[PhishGuard] Riesgo: ALTO (puntaje: 67/100)
Remitente: security@paypa1-alerts.xyz
Asunto:    URGENTE: Tu cuenta ha sido suspendida

Indicadores detectados:
  - CRITICO: El dominio del remitente imita a paypal.com
  - ALTO: Fallo en la validacion SPF
  - ALTO: El cuerpo solicita informacion sensible (contrasena, tarjeta de credito)
  - MEDIO: 4 palabras de urgencia detectadas

Analisis de IA: Este correo exhibe patrones clasicos de phishing dirigidos
a usuarios de PayPal. El dominio usa sustitucion de caracteres (paypa1 vs paypal).

Accion tomada: Correo en cuarentena + notificacion enviada a Slack.