- name
- m5-email-reader
- description
- 只读邮件助手，通过 POP3 协议读取163、QQ、Gmail、Outlook等任意邮箱的邮件。支持：查询邮件总数、获取最近若干封邮件的标题列表、读取邮件完整内容（正文+附件信息）、按序号读取指定邮件、按关键词搜索邮件主题。当用户询问"帮我看看邮件"、"读一下邮箱"、"邮件里有没有XX"、"最近有什么邮件"、"查一下邮箱里的验证码"等邮件读取相关需求时使用。
Email Reader
通过 POP3 SSL 协议只读邮箱，支持任意标准 POP3 邮箱。所有操作只读，不会删除或修改邮件。
核心脚本
scripts/email_reader.py — 所有功能入口，JSON 输出。
# 查总数
python3 scripts/email_reader.py count
# 最近 10 封标题（仅头部，速度快）
python3 scripts/email_reader.py subjects --n 10
# 最近 5 封完整内容（含正文）
python3 scripts/email_reader.py list --n 5
# 按序号读指定邮件
python3 scripts/email_reader.py read --index 42
# 在最近 100 封中搜索主题含关键词的邮件
python3 scripts/email_reader.py search --keyword 验证码 --range 100配置方式（三层优先级，高优先级覆盖低优先级）
方式 1：命令行参数（最高优先级，适合临时测试）
python3 scripts/email_reader.py \
--user your@163.com \
--pass_ YOUR_AUTH_CODE \
--server pop.163.com \
--port 995 \
subjects --n 5方式 2：环境变量（推荐，安全可靠）
export EMAIL_USER="your@163.com"
export EMAIL_PASS="YOUR_AUTH_CODE"
export POP3_SERVER="pop.163.com"
export POP3_PORT="995"
python3 scripts/email_reader.py subjects --n 5在 OpenClaw 中，可通过 gateway config.patch 将环境变量写入全局配置：
{
"env": {
"EMAIL_USER": "your@163.com",
"EMAIL_PASS": "YOUR_AUTH_CODE",
"POP3_SERVER": "pop.163.com",
"POP3_PORT": "995"
}
}方式 3：.email_config 文件（适合本地使用，不推荐提交到版本库）
在 scripts/ 目录下创建 .email_config：
[email]
user = your@163.com
pass_ = YOUR_AUTH_CODE
server = pop.163.com
port = 995⚠️ 安全提醒：.email_config含明文密码，请确保文件权限为600，并加入.gitignore。
邮箱服务器配置
各邮箱 POP3 服务器地址和授权码获取方式，参见 references/providers.md。
163邮箱快捷配置：
- Server:
pop.163.com，Port:995 - 需使用授权码而非登录密码（邮箱设置 → POP3/SMTP → 开启 → 获取授权码）
工作流程
- 先询问用户的邮箱账号、授权码（密码）、邮箱类型
- 根据邮箱类型查
references/providers.md确认服务器地址 - 决定配置方式（推荐环境变量），完成配置
- 运行脚本，解析 JSON 输出后以自然语言回复用户
输出格式
脚本统一输出 JSON，agent 解析后转为自然语言回复用户。示例：
{
"total": 523,
"emails": [
{
"index": 523,
"subject": "【网易】您的账户安全提醒",
"from": "noreply@163.com",
"date": "2026-03-25 10:30:00"
}
]
}注意事项
- 首次连接慢属正常（POP3 需要完整下载邮件）
subjects子命令只拉取头部，比list快得多，适合先浏览再精读- 邮件
index从 1 开始，数字越大越新 - 正文超长时建议截取前 2000 字符展示