AI助手邮件管理技能，实时通知、智能分类（7类）、验证码提取、HTML内容安全处理
电子邮件 Bridge Skill. 电子邮件管理技能, 用于 OpenClaw. 提供实时电子邮件监控, 并给 AI 助手提供智能分类和干净通知.
功能概述
电子邮件 Bridge Skill. 电子邮件管理技能, 用于 OpenClaw. 提供实时电子邮件监控, 并给 AI 助手提供智能分类和干净通知.是一项面向实际任务的技能，主要用于Features. real-time adviews。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
Email Bridge 技能
OpenClaw 的邮件管理技能。提供实时邮件监控、智能分类及面向 AI 助手的简洁通知。
功能特性
- 实时通知：IMAP IDLE（QQ 邮箱 / 网易邮箱）+ 轮询（Gmail）
- 智能分类：7 类邮件，仅基于邮件主题进行分类
- 验证码提取：上下文感知提取，误报率低
- HTML 内容净化：从 HTML 邮件中提取干净文本，移除不可见字符
- 提示注入防护：确保邮件内容可安全用于 AI 处理
- 多服务商支持：Gmail（API）、QQ 邮箱（IMAP）、网易邮箱（IMAP）
安装
cd skills/email-bridge pip install -e .
配置（需手动使用 CLI）
⚠️ 安全提示：切勿在聊天中分享授权码。仅可通过 CLI 配置账号。
# 添加账号（安全地交互式提示输入授权码） email-bridge accounts add your@qq.com -p qq # 同步邮件 email-bridge sync # 启动守护进程以实现实时通知 email-bridge daemon start -d
获取授权码
QQ 邮箱： https://service.mail.qq.com/detail/0/75（发送短信，获取 16 位授权码）
网易邮箱（163/126）： 设置 → POP3/SMTP/IMAP → 启用 → 获取授权码
Gmail： 需完成 OAuth 配置（参见 README.md）
能力
- 接收邮件：同步并读取已配置账号的邮件
- 发送邮件：通过 SMTP 发送邮件
- 实时通知：通过
openclaw system event推送至 OpenClaw - 智能分类：7 类邮件，基于关键词进行分类
- 验证码提取：上下文感知提取，误报率低
- 链接提取：从邮件中提取操作链接（如验证、重置等）
- HTML 净化：提取干净文本并移除不可见字符
- 提示注入防护：对邮件内容进行净化，保障 AI 处理安全
邮件分类
仅基于邮件主题的分类方式，兼顾速度与可靠性：
| 分类 | 图标 | 说明 | 示例关键词 |
|---|---|---|---|
| verification | 🔐 | 验证码、激活类邮件 | 验证码, OTP, activate, 绑定邮箱 |
| security | ⚠️ | 安全提醒、登录告警 | 安全提醒, security alert, 密码修改 |
| transactional | 📦 | 订单、支付、物流通知 | 订单确认, receipt, 发货通知 |
| promotion | 🎁 | 营销推广、优惠活动、奖励发放 | 奖励, 优惠, promo, discount |
| subscription | 📰 | 新闻简报、定期摘要 | newsletter, 订阅, weekly digest |
| spam_like | 🚫 | 疑似垃圾邮件 | 中奖, FREE, click here now |
| normal | — | 普通邮件 | (默认) |
触发关键词
中文： 邮箱、邮件、发邮件、查看邮件、验证码、QQ邮箱、Gmail
英文： email, mail, send email, check email, verification code
常用命令
# 列出最近 10 封邮件 email-bridge messages list -n 10 # 从最近邮件中提取验证码 email-bridge codes # 发送邮件 email-bridge send -a-t recipient@example.com -s "Subject" -b "Body" # 守护进程管理 email-bridge daemon status email-bridge daemon stop
配置
配置文件路径：~/.email-bridge/config.json
默认配置（自动生成，最小化）：
{
"daemon": {
"poll_interval": 300,
"notify_openclaw": true
}
}
完整配置（含全部可选项）（按需自定义）：
{
"daemon": {
"poll_interval": 300,
"notify_openclaw": true,
"notification": {
"include_body": false,
"body_max_length": 500,
"include_verification_codes": true,
"include_links": false
}
}
}
通知选项
| 选项 | 默认值 | 说明 |
|---|---|---|
include_body |
false |
是否在通知中包含邮件正文预览 |
body_max_length |
500 |
正文预览的最大字符数 |
include_verification_codes |
true |
自动提取并显示验证码 |
include_links |
false |
是否包含操作链接（如验证、重置等） |
通知格式
当新邮件到达时，守护进程将发送结构化通知：
📧 新邮件: account@qq.com 1. 🔐 Google 您的验证码 ✨ 验证码: 123456 2. ⚠️ Microsoft 登录提醒 📝 We noticed a new sign-in... 3. 🎁 OKX 150 USDT 奖励等您拿 📝 亲爱的欧易用户，欧易诚邀您加入邀请好友计划...
HTML 内容处理
纯 HTML 邮件将按以下流程处理：
- 标签剥离：移除