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)
- Ejecuta verificaciones de reglas estaticas (typosquatting, palabras de urgencia, URLs sospechosas, fallas de autenticacion)
- Envia el correo a la API de Claude para un analisis semantico de phishing
- Combina ambos puntajes en un nivel de riesgo final: BAJO / MEDIO / ALTO / CRITICO
- Toma la accion correspondiente segun el nivel de riesgo
Niveles de riesgo y acciones
| Nivel de riesgo | Puntaje | Accion tomada |
|---|
| BAJO | 0-24 | Entrega normal, sin accion |
| MEDIO |
25-49 | Agrega etiqueta de advertencia al correo |
| ALTO | 50-74 | Cuarentena + alerta al usuario + notificacion a Slack/Teams |
| CRITICO | 75-100 | Cuarentena + 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 - INLINECODE2 — detiene el ciclo de revision
- INLINECODE3 — analiza un correo individual bajo demanda
- INLINECODE4 — 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 - INLINECODE7 — obtener el contenido completo y cabeceras del mensaje
- INLINECODE8 — agregar etiquetas (cuarentena, advertencia)
- INLINECODE9 O
teams:send-message — enviar notificaciones de alerta (opcional)
Variables de entorno
| Variable | Requerida | Por defecto | Descripcion |
|---|
| ANTHROPICAPIKEY | Si | — | API key de Claude para el analisis de IA |
| SLACKWEBHOOKURL |
No | — | Webhook de Slack para alertas |
| TEAMS
WEBHOOKURL | No | — | Webhook de Teams para alertas |
| GMAIL
CHECKINTERVAL_SECONDS | No | 60 | Frecuencia de revision de Gmail en segundos |
| PHISHGUARD
QUARANTINELABEL | No | PhishGuard-Cuarentena | Etiqueta de Gmail para correos en cuarentena |
Formato de salida
Cuando se analiza un correo, PhishGuard reporta lo siguiente:
CODEBLOCK0
技能 PhishGuard
功能说明
该技能自动监控收件箱中的钓鱼攻击。它在后台运行,并以可配置的时间间隔检查新邮件。
当收到新邮件时,PhishGuard:
- 1. 提取发件人、主题、正文、URL和认证头(SPF/DKIM)
- 执行静态规则检查(域名仿冒、紧急词汇、可疑URL、认证失败)
- 将邮件发送至Claude API进行语义钓鱼分析
- 将两个评分合并为最终风险等级:低 / 中 / 高 / 严重
- 根据风险等级执行相应操作
风险等级与操作
| 风险等级 | 评分 | 执行操作 |
|---|
| 低 | 0-24 | 正常投递,不执行操作 |
| 中 |
25-49 | 为邮件添加警告标签 |
| 高 | 50-74 | 隔离 + 向用户发送警报 + 向Slack/Teams发送通知 |
| 严重 | 75-100 | 隔离 + 向用户发送警报 + 向Slack/Teams发送通知 + 记录日志 |
如何调用该技能
您可以通过以下方式让OpenClawd执行PhishGuard:
- - 启动钓鱼监控
- 检查我的收件箱是否存在钓鱼邮件
- 分析这封邮件:[粘贴邮件内容]
- 显示今天的PhishGuard报告
- 停止PhishGuard监控
内部工作原理
该技能实现在phishguard.js中。它暴露以下主要函数:
- - startMonitoring(context) — 启动后台邮件检查循环
- stopMonitoring(context) — 停止检查循环
- analyzeEmail(emailData, context) — 按需分析单封邮件
- getReport(context) — 返回当前会话的检测摘要
当监控处于活动状态时,该技能使用OpenClawd中可用的Gmail工具,每隔N秒(默认:60秒)查询Gmail。对于每封之前未见过的未读邮件,执行analyzeEmail()并根据结果采取行动。
所需的OpenClawd工具
该技能使用以下工具,这些工具必须在您的OpenClawd实例中启用:
- - gmail:list-messages — 列出未读消息
- gmail:get-message — 获取消息的完整内容和头部信息
- gmail:modify-message — 添加标签(隔离、警告)
- slack:send-message 或 teams:send-message — 发送警报通知(可选)
环境变量
| 变量 | 必需 | 默认值 | 描述 |
|---|
| ANTHROPICAPIKEY | 是 | — | 用于AI分析的Claude API密钥 |
| SLACKWEBHOOKURL |
否 | — | 用于警报的Slack Webhook |
| TEAMS
WEBHOOKURL | 否 | — | 用于警报的Teams Webhook |
| GMAIL
CHECKINTERVAL_SECONDS | 否 | 60 | Gmail检查频率(秒) |
| PHISHGUARD
QUARANTINELABEL | 否 | PhishGuard-隔离区 | 用于隔离邮件的Gmail标签 |
输出格式
当分析邮件时,PhishGuard报告如下内容:
[PhishGuard] 风险等级:高(评分:67/100)
发件人:security@paypa1-alerts.xyz
主题: 紧急:您的账户已被暂停
检测到的指标:
- 严重:发件人域名仿冒paypal.com
- 高:SPF验证失败
- 高:正文要求提供敏感信息(密码、信用卡)
- 中:检测到4个紧急词汇
AI分析:此邮件展示针对PayPal用户的典型钓鱼模式。域名使用了字符替换(paypa1 vs paypal)。
已执行操作:邮件已隔离 + 已向Slack发送通知。