Email Bridge Skill

Email management skill for OpenClaw. Provides real-time email monitoring with smart categorization and clean notifications for AI assistants.

Features

Real-time notifications: IMAP IDLE (QQ/NetEase) + polling (Gmail)
Smart categorization: 7 categories with subject-only classification
Verification code extraction: Context-aware, low false positive rate
HTML content sanitization: Clean text from HTML emails, remove invisible chars
Prompt injection protection: Safe email content for AI processing
Multi-provider support: Gmail (API), QQ Mail (IMAP), NetEase (IMAP)

Installation

cd skills/email-bridge
pip install -e .

Setup (Manual CLI Required)

⚠️ Security Note: Do NOT share authorization codes in chat. Configure accounts via CLI only.

# Add account (prompts for authorization code securely)
email-bridge accounts add your@qq.com -p qq

# Sync emails
email-bridge sync

# Start daemon for real-time notifications
email-bridge daemon start -d

Getting Authorization Codes

QQ Mail: https://service.mail.qq.com/detail/0/75 (send SMS, get 16-char code)

NetEase (163/126): Settings → POP3/SMTP/IMAP → Enable → Get code

Gmail: Requires OAuth setup (see README.md)

Capabilities

Receive emails: Sync and read emails from configured accounts
Send emails: Send emails via SMTP
Real-time notifications: Push to OpenClaw via openclaw system event
Smart categorization: 7 categories with keyword-based classification
Verification code extraction: Context-aware extraction with low false positives
Link extraction: Extract action links from emails
HTML sanitization: Clean text extraction with invisible char removal
Prompt injection protection: Sanitize email content for safe AI processing

Email Categories

Subject-only classification for fast, reliable categorization:

Category	Icon	Description	Example Keywords
----------	------	-------------	------------------
verification	🔐	Verification codes, activation	验证码, OTP, activate, 绑定邮箱
security	⚠️	Security alerts, login warnings	安全提醒, security alert, 密码修改
transactional	📦	Orders, payments, shipping	订单确认, receipt, 发货通知
promotion	🎁	Marketing, promotions, rewards	奖励, 优惠, promo, discount
subscription	📰	Newsletters, digests	newsletter, 订阅, weekly digest
spam_like	🚫	Suspected spam	中奖, FREE, click here now
normal	—	Regular email	(default)

Trigger Keywords

Chinese: 邮箱、邮件、发邮件、查看邮件、验证码、QQ邮箱、Gmail

English: email, mail, send email, check email, verification code

Common Commands

# List recent emails
email-bridge messages list -n 10

# Get verification codes from recent emails
email-bridge codes

# Send email
email-bridge send -a <account_id> -t recipient@example.com -s "Subject" -b "Body"

# Daemon management
email-bridge daemon status
email-bridge daemon stop

Configuration

Configuration file: ~/.email-bridge/config.json

Default configuration (auto-generated, minimal):

{
  "daemon": {
    "poll_interval": 300,
    "notify_openclaw": true
  }
}

Full configuration with all options (customize as needed):

{
  "daemon": {
    "poll_interval": 300,
    "notify_openclaw": true,
    "notification": {
      "include_body": false,
      "body_max_length": 500,
      "include_verification_codes": true,
      "include_links": false
    }
  }
}

Notification Options

Option	Default	Description
--------	---------	-------------
`include_body`	`false`	Include email body preview in notifications
`body_max_length`	`500`	Max characters for body preview
`include_verification_codes`	`true`	Auto-extract and show verification codes
`include_links`	`false`	Include action links (verify/reset)

Notifications

When new emails arrive, the daemon sends formatted notifications:

📧 新邮件: account@qq.com

1. 🔐 Google
   您的验证码
   ✨ 验证码: 123456

2. ⚠️ Microsoft
   登录提醒
   📝 We noticed a new sign-in...

3. 🎁 OKX
   150 USDT 奖励等您拿
   📝 亲爱的欧易用户，欧易诚邀您加入邀请好友计划...

HTML Content Processing

HTML-only emails are processed through:

Tag stripping: Remove

Email Bridge

概述