邮件摘要

自动驱动浏览器登录多邮箱，抓取当天邮件并生成结构化摘要日报，支持多种邮箱与定时任务。

Install

openclaw skills install @thcjp/email-digest-free

功能说明: 本技能涵盖自动化配置和灵活的参数设置、时使用、化配置和灵活的参数设置等核心能力。

功能说明: 本技能涵盖化工作流场景等核心能力。

Email Daily Summary

通过 browser-use CLI 驱动浏览器自动化登录 Web 邮箱,抓取当日邮件并生成结构化日报。优先复用本机 Chrome 已登录会话(--browser real),避免在脚本中存储明文密码.

输入参数

参数名	类型	必填	说明
input	string	是	Email Daily Summary处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

专业版增强能力

能力	免费版	付费版
基础功能	支持	支持
Email Daily Summary自动登录邮箱并生成	不支持	支持
多标签页并行抓取	不支持	支持
反爬虫策略自动规避	不支持	支持
页面结构变化自适应	不支持	支持
批量导出结构化数据	不支持	支持

安装与配置

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

分类: MD+EXEC（）

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

功能能力

多邮箱自动登录:复用 Chrome 已登录会话(--browser real)或 --headed 手动登录,覆盖 Gmail、Outlook、QQ 邮箱、163/126 邮箱、企业微信邮箱
邮件列表抓取:通过 DOM 选择器提取收件箱行(tr.zA 等),获取发件人、主题、摘要片段、时间戳四元组
统计聚合:实时计算未读数(.zE)、可见总数、按发件人域名/主题关键词分类
AI 智能摘要:browser-use extract 用自然语言指令提取前 N 封邮件并按重要性排序
截图归档:每日 inbox 快照保存为 PNG,按日期归档到本地目录
定时调度:提供 crontab(Linux/macOS)与 launchd(macOS)两种调度模板,每日定时触发
跨账号汇总:顺序遍历多个邮箱 URL,合并生成统一的跨账号日报
关键词监控:命中白名单发件人或主题关键词时,在日报中高亮并加入"建议操作"区块

前置依赖

安装 browser-use CLI:

bash

uv pip install browser-use[cli]
browser-use install

在本机 Chrome 中至少登录过一次目标邮箱(用于 --browser real 复用会话)
操作系统:Windows / macOS / Linux 均可,定时任务依赖 crontab 或 launchd

支持的邮箱服务

邮箱服务	登录 URL	收件箱 URL
Gmail	https://accounts.google.com	https://mail.google.com
Outlook	https://login.live.com	https://outlook.live.com
QQ 邮箱	https://mail.qq.com	https://mail.qq.com
163 邮箱	https://mail.163.com	https://mail.163.com
126 邮箱	https://mail.126.com	https://mail.126.com
企业微信邮箱	https://exmail.qq.com	https://exmail.qq.com

使用指南

确认 browser-use --version 可正常输出,否则按前置依赖安装
选择登录方式:已登录 Chrome 用 --browser real,首次登录用 --headed
打开收件箱 URL,browser-use state 探测当前 DOM 结构
执行 eval 脚本提取邮件四元组,或 extract 让 AI 自然语言提取
聚合统计、生成 Markdown 日报,screenshot 归档快照
browser-use close 释放浏览器会话

适用范围

场景 1:每日晨间邮件简报

输入:Gmail 收件箱 URL + 当日日期(如 2026-07-20)
输出:Markdown 日报,含未读数、Top 5 重要邮件、分类统计、建议操作;附 inbox_2026-07-20.png 截图
触发:crontab 每日 09:00 自动执行

场景 2:多账号跨邮箱汇总

输入:多个邮箱配置(Gmail + QQ 邮箱 + 企业微信邮箱)
输出:合并日报,按邮箱分节展示,统一统计未读总数与重要邮件清单
触发:用户主动请求或每日定时

场景 3:重要发件人监控告警

输入:发件人白名单(如 boss@company.com、finance@bank.com)
输出:命中邮件列表,含主题、时间、摘要片段;若命中则在日报顶部加红标记
触发:每小时轮询或事件驱动

场景 4:周报邮件统计

输入:周起止日期(如 2026-07-14 至 2026-07-20)
输出:周邮件量趋势、Top 10 发件人、分类占比、未处理邮件清单
触发:每周一 09:00 自动执行

案例展示

案例 1:生成今日 Gmail 日报

bash

DATE=$(date +%Y-%m-%d)
OUTPUT_DIR="./email_summaries"
mkdir -p "$OUTPUT_DIR"
# ...
browser-use --browser real open https://mail.google.com
sleep 3
# ...
# 探测页面状态
browser-use state
# ...
# 截图归档
browser-use screenshot "$OUTPUT_DIR/inbox_$DATE.png"
# ...
# 提取前 20 封邮件四元组
browser-use eval "
  const emails = [];
  document.querySelectorAll('tr.zA').forEach((row, i) => {
    if (i < 20) {
      const sender = row.querySelector('.yX.xY span')?.innerText || '';
      const subject = row.querySelector('.y6 span')?.innerText || '';
      const snippet = row.querySelector('.y2')?.innerText || '';
      const time = row.querySelector('.xW.xY span')?.innerText || '';
      emails.push({ sender, subject, snippet, time });
    }
  });
  JSON.stringify(emails, null, 2);
"
# ...
# 未读统计
browser-use eval "
(() => {
  const unread = document.querySelectorAll('.zE').length;
  const visible = document.zA').length;
  return JSON.stringify({ unread, visible, timestamp: new Date().toISOString() });
})()
"
# ...
browser-use close

输出示例:

text

==========================================
邮件日报 - 2026-07-20
==========================================
统计概览:
- 未读邮件: 12 封
- 可见邮件: 50 封
- 命中白名单: 2 封
# ...
重要邮件:
1. boss@company.com | 项目进度汇报 - 紧急 | 09:30
2. finance@bank.com | 账单提醒 | 08:15
# ...
建议操作:
- 回复 boss@company.com
- 处理 3 封审批邮件
==========================================

案例 2:监控 boss@company.com 邮件

bash

sleep 3
# ...
browser-use eval "
  const hits = [];
  document.zA').forEach(row => {
querySelector('.yX.xY span')?.innerText || '';
    if (sender.toLowerCase().includes('boss@company.com')) {
      hits.push({
        sender,
        subject: row.querySelector('.y6 span')?.innerText || '',
        time: row.querySelector('.xW.xY span')?.innerText || ''
      });
    }
  });
  JSON.stringify(hits, null, 2);
"

输出示例:

json

[
  { "sender": "boss@company.com", "subject": "项目进度汇报 - 紧急", "time": "09:30" },
com", "subject": "周一晨会议程", "time": "07:45" }
]

案例 3:多账号(Gmail + QQ 邮箱)合并日报

bash

DATE=$(date +%Y-%m-%d)
REPORT="$OUTPUT_DIR/daily_$DATE.md"
echo "# 跨邮箱日报 $DATE" > "$REPORT"
# ...
# Gmail 分节
sleep 3
echo "## Gmail" >> "$REPORT"
browser-use extract "提取前 10 封邮件的发件人、主题、时间,按重要性排序" >> "$REPORT"
browser-use close
# ...
# QQ 邮箱分节
sleep 3
echo "## QQ 邮箱" >> "$REPORT"
browser-use extract "提取前 10 封邮件的发件人、主题、时间,按重要性排序" >> "$REPORT"
browser-use close
# ...
echo "报告已生成: $REPORT"

定时任务

Linux/macOS (crontab)

bash

crontab -e
# 每日 09:00 执行
0 9 * * * /path/to/email_daily_summary.sh >> /path/to/logs/email_summary.log 2>&1

macOS (launchd)

创建 $HOME/Library/LaunchAgents/com.email.dailysummary.plist,设置 StartCalendarInterval 为 Hour=9, Minute=0,ProgramArguments 指向脚本路径,然后:

bash

launchctl load $HOME/Library/LaunchAgents/com.email.dailysummary.plist

异常响应

1. browser-use CLI 未安装或不可用

现象:执行 browser-use 报 command not found
处理:uv pip install browser-use[cli] 后再执行 browser-use install 安装浏览器依赖

2. Chrome 会话过期或未登录

现象:--browser real 打开邮箱后跳转到登录页
处理:切换 --headed 模式手动登录一次,或在本机 Chrome 中重新登录目标邮箱后

3. CSS 选择器失效(DOM 改版)

现象:eval 返回空数组或 unread: 0 但页面明显有未读邮件
处理:browser-use state 重新探测当前 DOM,更新选择器(如 Gmail 由 tr.zA 改为 tr.zB),并将新选择器写入配置

4. 登录遇到二次验证或验证码

现象:登录流程卡在 SMS 验证码或图形验证码页面
处理:必须使用 --headed 模式由人工完成验证;自动化流程不可规避验证码

5. 邮件列表加载缓慢

现象:state 显示页面已加载但 tr.zA 数量为 0
处理:在 open 与 eval 之间插入 sleep 5,或循环 browser.scroll('down') 触发懒加载

6. screenshot 写入失败

现象:browser-use screenshot 报权限错误或路径不存在
处理:执行前 mkdir -p "$OUTPUT_DIR" 创建目录,确认运行用户对目录有写权限

7. eval 脚本执行超时

现象:邮件量大(>100 封)时 eval 单次执行超过浏览器脚本超时阈值
处理:分批抓取,每次 i < 20,滚动后再抓取下一批,合并结果

8. crontab 环境变量缺失

现象:手动执行正常,crontab 触发时报 browser-use: command not found
处理:在脚本顶部显式 export PATH=/usr/local/bin:/opt/homebrew/bin:$PATH,或使用 browser-use 绝对路径

指南中心

Q1:如何避免在脚本中保存邮箱密码?

优先使用 --browser real 模式复用本机 Chrome 已登录会话,凭证由 Chrome 管理,脚本不接触密码。必须登录时,密码从系统环境变量或 keyring 读取,不硬编码.

Q2:如何同时汇总多个邮箱?

顺序执行多个 browser-use --browser real open <url> 块,每个邮箱独立 extract 后追加到同一份 Markdown 报告,按邮箱分节展示。参考案例 3.

Q3:AI 摘要功能(`extract`)需要什么配置?

extract 依赖 browser-use 内置 LLM,需配置 OPENAI_API_KEY 或同等 LLM 凭证。未配置时降级为纯 eval 抓取四元组,不生成 AI 摘要.

Q4:如何切换到无头模式?

将 --browser real 替换为 --headless,但无头模式无法复用 Chrome 已登录会话,需改用 token 或手动登录流程。生产环境定时任务推荐保持 --browser real 并锁定屏幕.

Q5:截图保存路径如何自定义?

通过 OUTPUT_DIR 环境变量控制,默认 ./email_summaries。建议设置为绝对路径(如 /var/log/email_summaries)以便定时任务稳定写入.

Q6:邮件量很大(>100 封)时如何处理?

分页抓取:每次 eval 取 20 封,browser.scroll('down') 触发加载,sleep 1 等待渲染,循环至 tr.zA 数量不再增长。合并所有批次后生成日报.

限制条件

CSS 选择器依赖邮箱 Web 版 DOM 结构,Gmail/Outlook 改版可能导致 tr.zA、.zE 等选择器失效,需定期校验
--browser real 需要本机 Chrome 已登录目标邮箱,服务器或无 GUI 环境不适用
验证码、二次验证、风险控制验证必须人工干预,无法全自动规避
仅支持 Web 邮箱自动化,不支持 IMAP/POP/SMTP 协议直连
单次抓取受浏览器渲染性能限制,超大量邮箱(>500 封/日)建议改用 IMAP 方案
QQ 邮箱、163 邮箱的 Web 版反自动化策略可能导致 --browser real 失效,需 --headed 人工辅助
截图为整页快照,长收件箱可能被截断,需配合滚动分页截图

安全提示

不在脚本中明文保存密码,优先 --browser real 复用会话
敏感凭证使用环境变量或系统 keyring 存储
定期检查邮箱授权应用列表,移除不需要的第三方访问
启用邮箱两步验证,自动化仅复用已登录会话不规避验证
日志文件不记录邮件正文,仅记录发件人、主题、时间元数据

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

差异化分析

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
邮件阅读	30分钟/封	1分钟/封	29分钟	95%
邮件筛选	10分钟/封	1分钟/封	9分钟	98%
邮件分类	5分钟/封	1分钟/封	4分钟	99%
邮件统计	20分钟	2分钟	18分钟	100%
邮件摘要	15分钟/封	1分钟/封	14分钟	97%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
自动化程度	高	低	中	高
操作便捷性	高	低	中	高
功能丰富性	高	低	中	高
成本效益	高	低	中	高
适应场景	广泛	有限	有限	有限

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
邮件处理效率低	邮件处理耗时，影响工作效率	个人、团队	邮件自动化处理	时间节约30%
邮件信息遗漏	邮件信息处理不全面，可能导致重要信息遗漏	个人、团队	邮件智能摘要	准确率提升98%
邮件分类困难	邮件分类工作量大，容易出错	个人、团队	邮件自动分类	准确率提升99%

邮件摘要

Install

Email Daily Summary

输入参数

专业版增强能力

安装与配置

运行环境

依赖项

API Key 配置

可用性分类

功能能力

前置依赖

支持的邮箱服务

使用指南

适用范围

场景 1:每日晨间邮件简报

场景 2:多账号跨邮箱汇总

场景 3:重要发件人监控告警

场景 4:周报邮件统计

案例展示

案例 1:生成今日 Gmail 日报

案例 2:监控 boss@company.com 邮件

案例 3:多账号(Gmail + QQ 邮箱)合并日报

定时任务

Linux/macOS (crontab)

macOS (launchd)

异常响应

1. browser-use CLI 未安装或不可用

2. Chrome 会话过期或未登录

3. CSS 选择器失效(DOM 改版)

4. 登录遇到二次验证或验证码

5. 邮件列表加载缓慢

6. screenshot 写入失败

7. eval 脚本执行超时

8. crontab 环境变量缺失

指南中心

Q1:如何避免在脚本中保存邮箱密码?

Q2:如何同时汇总多个邮箱?

Q3:AI 摘要功能(extract)需要什么配置?

Q4:如何切换到无头模式?

Q5:截图保存路径如何自定义?

Q6:邮件量很大(>100 封)时如何处理?

限制条件

安全提示

安全风险防范

差异化分析

效率提升量化分析

差异化对比

核心痛点解决

Related skills

Q3:AI 摘要功能(`extract`)需要什么配置?