邮箱验证器（Email Validator）

Claw0x 开发的本地技能 —— 完全在您的 OpenClaw agent 中运行。

验证邮箱地址的格式正确性，并评估其风险等级。所有逻辑均在本地执行，不调用任何外部 API。

完全本地运行。 无需调用外部 API，也无需 API 密钥。全程隐私保护。

前置条件

无。 安装后即可直接使用。

快速参考

5 分钟快速上手

步骤 1：安装（30 秒）

openclaw skills install email-validator

步骤 2：使用（1 分钟）

const result = await agent.run('email-validator', {
  email: 'user@example.com'
});

console.log(result.valid); // true/false
console.log(result.risk_score); // 10–100

步骤 3：获取结果（即时返回）

{
  "valid": true,
  "email": "user@example.com",
  "checks": {
    "format_valid": true,
    "domain": "example.com",
    "local_part": "user",
    "is_disposable": false
  },
  "risk_score": 10,
  "suggestion": null
}

工作原理 —— 底层实现

100% 本地处理，零外部 API 调用，完整隐私保障。

该技能完全在您的 agent 运行环境中通过纯 TypeScript 逻辑执行。所有验证均基于本地运算，包括：

• 使用正则表达式进行格式校验
• 字符串操作提取域名
• 内置域名列表的数组查找匹配
• 基于简单算术的风险分值计算

步骤 1：本地格式验证（遵循 RFC 5322）

使用正则表达式模式在本地检查邮箱结构：

• 本地部分（@ 符号前）：长度为 1–64 字符，仅允许字母、数字、点（.）、短横线（-）、下划线（_）和加号（+）
• 域名部分（@ 符号后）：符合规范的主机名，且包含有效顶级域（TLD）
• 总长度：3–254 字符

不发起任何网络请求，纯字符串匹配。

步骤 2：本地域名分析

将提取出的域名与代码中内置的域名列表进行比对：

• 一次性域名列表：涵盖 10+ 已知提供商（如 mailinator.com、guerrillamail.com 等）
• 免费邮箱提供商列表：涵盖 8+ 常见服务商（如 gmail.com、yahoo.com 等）
• 企业域名：未出现在上述任一列表中的域名

不执行 DNS 查询，纯数组查找。

步骤 3：本地风险分值计算

通过简单算术规则计算风险分值：

不依赖任何外部评分 API，纯数学运算。

分值越低，邮箱越安全。

该技能 不支持 的功能

• 不支持 SMTP 验证：不会连接邮件服务器
• 不支持 DNS MX 记录查询：不会验证邮件交换记录
• 不支持投递能力检测：无法预测邮件是否会被退回

这是设计使然。本技能专注于极致的速度、确定性以及零外部依赖性。

真实场景用例

场景 1：注册表单验证

问题：注册过程中过滤虚假邮箱 解决方案：验证邮箱格式并识别一次性域名 示例：

const result = await agent.run('email-validator', {
  email: 'test@mailinator.com'
});

if (result.risk_score > 70) {
  console.log('检测到一次性邮箱');
}

场景 2：批量邮箱列表清洗

问题：营销活动前清理邮箱列表 解决方案：批量验证所有邮箱，并剔除无效项 示例：

const emails = ['user1@example.com', 'invalid@', 'user2@gmail.com'];
const results = await Promise.all(
  emails.map(email => agent.run('email-validator', { email }))
);

const validEmails = results
  .filter(r => r.valid && r.risk_score < 50)
  .map(r => r.email);

场景 3：B2B 销售线索分级

问题：优先处理企业邮箱，降低免费邮箱权重 解决方案：利用风险分值对销售线索排序 示例：

const result = await agent.run('email-validator', {
  email: 'ceo@company.com'
});

// 企业域名 → 低风险分值（10–20）
// 免费邮箱提供商 → 中等风险（20–30）
// 一次性邮箱 → 高风险（80–100）

集成方案

OpenClaw Agent

import { Claw0xClient } from '@claw0x/sdk';

const claw0x = new Claw0xClient(process.env.CLAW0X_API_KEY);

agent.onUserInput(async (input) => {
  if (input.includes('@')) {
    const result = await claw0x.call('email-validator', {
      email: input
    });
    
    if (!result.valid) {
      return '邮箱格式无效';
    }
    
    if (result.checks.is_disposable) {
      return '不接受一次性邮箱';
    }
  }
});

LangChain Agent

from claw0x import Claw0xClient

client = Claw0xClient(api_key=os.environ['CLAW0X_API_KEY'])

def validate_email(email: str) -> dict:
    result = client.call('email-validator', {'email': email})
    return result

# 在链中使用
email = "user@example.com"
validation = validate_email(email)
if validation['valid']:
    print(f"邮箱格式有效，风险分值为：{validation['risk_score']}")

自定义 Agent

const response = await fetch('https://api.claw0x.com/v1/call', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.CLAW0X_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    skill: 'email-validator',
    input: { email: 'test@example.com' }
  })
});

const result = await response.json();
console.log(result);

输入 Schema

输出 Schema

{
  valid: boolean;              // 邮箱格式是否有效
  email: string;               // 标准化后的邮箱（已转为小写）
  checks: {
    format_valid: boolean;     // RFC 格式校验结果
    domain: string;            // 提取出的域名
    local_part: string;        // 提取出的本地部分（@ 符号前）
    is_disposable: boolean;    // 域名是否属于一次性邮箱提供商
  };
  risk_score: number;          // 风险分值（10 = 低风险，90 = 高风险）
  suggestion: string | null;   // 若格式无效，提供修正建议
}

错误处理

关于 Claw0x

本技能由 Claw0x 提供 —— AI agent 的原生技能层。

云版本可用：如需集中式分析能力，云版本可在 claw0x.com/skills/validate-email 获取。

探索更多技能：claw0x.com/skills

GitHub 仓库：github.com/kennyzir/validate-email