Only read email_办公效率 skill-PHP中文网

Only read email

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

只读邮件助手，通过 POP3 协议读取163、QQ、Gmail、Outlook等任意邮箱的邮件。支持：查询邮件总数、获取最近若干封邮件的标题列表、读取邮件完整内容（正文+附件信息）、按序号读取指定邮件、按关键词搜索邮件主题。当用户询问"帮我看看邮件"、"读一下邮箱"、"邮件里有没有XX"、"最近有什么邮件"、"查...

Email Reader

功能概述

Email Reader是一项面向实际任务的技能，主要用于通过 POP3 SSL 协议只读邮箱，支持任意标准 POP3 邮箱；所有操作只读，不会删除或修改邮件；

核心要点

scripts/email_reader.py — 所有功能入口，JSON 输出；
配置方式（三层优先级，高优先级覆盖低优先级）；
方式 1：命令行参数（最高优先级，适合临时测试）；

使用与执行

方式 2：环境变量（推荐，安全可靠）；在 OpenClaw 中，可通过。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

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"
    }
  ]
}