Install
openclaw skills install @thcjp/email-digestopenclaw skills install @thcjp/email-digest核心功能: 本技能提供中文交互、化流程场景等能力。
解决: 检查对应账户的浏览器登录状态,确保会话有效:
# 验证账户状态
email-digest-tool accounts health-check
# ...
# 重新登录失效账户
解决: 调整评分规则与关键词配置:
# 更新评分规则
email-digest-tool config update --ai-scoring rules.json
# ...
# 查看评分详情
email-digest-tool aggregate --accounts gmail --show-scores
解决: 检查推送渠道配置与网络:
# 测试推送渠道
email-digest-tool push test --channel feishu
# ...
# 查看推送日志
email-digest-tool push log --since "2026-07-01"
解决: 优化告警规则与静默策略:
# 查看告警频率统计
email-digest-tool alert stats
# ...
# 调整告警阈值
email-digest-tool alert update --name "unread-alert" --threshold 100
解决: 专业版支持多种格式互转:
# 格式转换
email-digest-tool convert --input report.html --format markdown
A: 在邮件日报专业版中,您可以通过配置文件为每个邮箱账户设置个性化的摘要规则。首先,编辑配置文件中的accounts部分,为每个账户指定一个唯一的name。然后,使用email-digest-tool config update --ai-scoring rules.json命令,为每个账户定义特定的关键词、评分规则和行动建议。例如,为销售团队邮箱设置更多关于销售数据和客户信息的摘要规则。
A: 邮件日报专业版在生成摘要时会自动识别邮件中的附件。对于附件,系统会提供附件的名称、大小和类型信息,并在摘要中提及。如果需要下载附件,您可以通过邮件日报专业版提供的链接直接下载。
A: 您可以在配置文件中为每个邮箱账户定义自定义标签。在accounts部分,为每个账户添加一个tags字段,列出所有自定义标签。邮件日报专业版会自动识别这些标签,并在摘要中相应地分类邮件。
A: 为了确保摘要的准确性和一致性,邮件日报专业版使用了预训练的自然语言处理模型,并结合自定义的评分规则和关键词。您可以通过email-digest-tool config update --ai-scoring rules.json命令调整这些规则,以适应特定的业务需求。此外,系统还提供了摘要的预览功能,允许您在生成最终摘要前进行手动审查。
A: 是的,邮件日报专业版支持邮件内容的翻译功能。您可以在配置文件中启用翻译功能,并指定目标语言。系统会自动将非英文邮件翻译成您指定的语言,以便于阅读和理解。请注意,翻译功能可能需要额外的API调用,具体取决于您的订阅计划。
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 邮件阅读与筛选 | 60分钟 | 5分钟 | 55分钟 | 20% |
| 邮件摘要生成 | 30分钟 | 3分钟 | 27分钟 | 15% |
| 邮件分类与标签 | 30分钟 | 5分钟 | 25分钟 | 10% |
| 邮件报告生成 | 60分钟 | 10分钟 | 50分钟 | 25% |
| 邮件推送与通知 | 30分钟 | 5分钟 | 25分钟 | 10% |
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 功能全面性 | 高 | 低 | 中 | 高 |
| 用户体验 | 高 | 低 | 中 | 高 |
| 配置复杂度 | 低 | 高 | 中 | 高 |
| 成本效益 | 高 | 低 | 中 | 高 |
| 自动化程度 | 高 | 低 | 中 | 高 |
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 邮件管理效率低 | 邮件数量多,手动处理效率低,容易遗漏重要邮件 | 影响工作效率和决策 | AI智能摘要和分类 | 提高工作效率20% |
| 邮件报告制作复杂 | 制作日报需要大量时间,且格式不统一 | 影响报告质量 | 定时报告推送和格式自定义 | 提高报告质量20% |
| 邮件监控困难 | 难以实时监控邮件状态和重要邮件 | 影响信息及时性 | 实时告警和趋势分析 | 提高信息及时性30% |
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 无法连接到邮箱 | 邮箱账户信息错误或网络问题 | 检查账户信息,重试连接或检查网络 | 修正账户信息,确保网络连接正常 |
| 报告生成失败 | 缺少必要配置或数据问题 | 检查配置文件和数据源 | 完善配置,确保数据源正确 |
| 告警未触发 | 告警规则配置错误或邮件内容不符合规则 | 检查告警规则和邮件内容 | 修正告警规则,确保邮件内容符合规则 |
| 定时任务未执行 | 定时任务配置错误或系统时间设置错误 | 检查定时任务配置和系统时间 | 修正定时任务配置,确保系统时间正确 |
| 输出格式错误 | 输出格式配置错误 | 检查输出格式配置 | 修正输出格式配置 |
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 邮件日报专业版企业级邮件监控 | 不支持 | 支持 |
| 多渠道消息批量发送 | 不支持 | 支持 |
| 消息模板与变量注入 | 不支持 | 支持 |
| 送达状态实时回调 | 不支持 | 支持 |
| 通信记录归档与检索 | 不支持 | 支持 |
企业管理者同时使用 Gmail(对外)和 Outlook(内部),需要每天早晨收到两个邮箱的统一摘要.
# 生成多邮箱聚合摘要
email-digest-tool aggregate \
--accounts gmail,outlook \
--date today \
--format html \
--output reports/daily_$(date +%Y%m%d).html
# ...
# 自动推送到飞书
email-digest-tool aggregate \
--accounts gmail,outlook \
--push feishu \
--webhook "https://open.feishu.cn/open-apis/bot/v2/hook/详情见说明"
输出报告示例:
==========================================
📧 多邮箱日报 - 2026-07-18
==========================================
# ...
📊 账户概览:
- Gmail (manager@company.com): 未读 15 封
- Outlook (manager@company.onmicrosoft.com): 未读 8 封
- 合计未读: 23 封
# ...
🔴 高优先级邮件 (3 封):
1. [Gmail] 来自 ceo@company.com
主题: 董事会决议 - 需要签字
时间: 08:45 | 评分: 9.5/10
建议: 立即处理
# ...
2. [Outlook] 来自 legal@company.com
主题: 合同审核 - 紧急
时间: 09:12 | 评分: 9.0/10
建议: 今日内回复
# ...
🟡 中优先级邮件 (12 封):
...
# ...
💡 AI 建议:
- 优先回复董事会决议邮件
- 3 封合同邮件需今日审批
- 5 封订阅邮件可批量归档
==========================================
设置每天早上9点自动生成摘要并推送到飞书群.
# 创建定时推送任务
email-digest-tool schedule create \
--name "morning-digest" \
--cron "0 9 * * 1-5" \
--accounts gmail,outlook \
--format markdown \
--push feishu \
feishu.cn/open-apis/bot/v2/hook/详情见说明" \
--timezone "Asia/Shanghai"
# ...
# 查看所有定时任务
email-digest-tool schedule list
# ...
# 查看任务执行历史
email-digest-tool schedule history --name "morning-digest"
配置当收到来自特定发件人或包含紧急关键词的邮件时立即告警.
# 配置告警规则
email-digest-tool alert create \
--name "ceo-alert" \
--condition "from:ceo@company.com" \
--channel feishu \
feishu.cn/open-apis/bot/v2/hook/详情见说明" \
--priority critical
# ...
email-digest-tool alert create \
--name "urgent-keyword" \
--condition "subject contains:紧急,urgent,critical" \
--channel email \
--notify "admin@company.com" \
--priority high
# ...
# 启动告警监控
email-digest-tool alert start --all
# ...
# 查看告警历史
email-digest-tool alert log --since "2026-07-01"
专业版完全兼容免费版,现有浏览器自动化流程可直接使用:
# 免费版命令依然有效
browser-use --browser real open https://mail.google.com
browser-use state
browser-use screenshot inbox.png
# ...
# 专业版新增命令
email-digest-tool aggregate --accounts gmail --format html
创建账户配置文件 ~/.config/email-digest-tool/accounts.json:
{
"accounts": [
{
"name": "Gmail工作邮箱",
"provider": "gmail",
"url": "https://mail.google.com",
"mode": "browser-session"
},
{
"name": "Outlook内部邮箱",
"provider": "outlook",
"url": "https://outlook.live.com",
"mode": "browser-session"
}
]
}
{
"push_channels": {
"feishu": {
"webhook": "https://open.feishu.cn/open-apis/bot/v2/hook/详情见说明"
},
"dingtalk": {
"webhook": "https://oapi.dingtalk.com/robot/send?access_token=详情见说明"
},
"slack": {
"webhook": "https://hooks.slack.com/services/详情见说明"
},
"email": {
"smtp_server": "smtp.company.com",
"port": 587,
"username": "bot@company.com",
"password": "your_password"
}
}
}
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 否 | 处理的内容输入 |
| mode | string | 否 | 处理模式, 可选值: json/text/markdown |
| style | string | 否 | 输出风格, 参考 references/style.md |
{
"success": true,
"data": {
"result": "处理结果",
"status": "success",
"metadata": {
"metadata": {
"template_used": "reviewer",
"word_count": 0,
"style": "专业"
}
},
"error": null
}
输出模板参考: assets/output.json
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 |
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
| browser-use | CLI工具 | 必需 | uv pip install browser-use[cli] |
| Chrome 浏览器 | 浏览器 | 必需 | 官方网站下载安装 |
| 邮箱账户 | 账户 | 必需 | 注册主流邮箱服务 |
| 推送渠道 Webhook | 集成 | 可选 | 飞书/钉钉/Slack 机器人配置 |
| cron 服务 | 系统服务 | 可选 | 系统自带(定时任务需要) |
| 数据库 | 存储引擎 | 可选 | 用于报告归档(可选 SQLite 文件存储) |
针对邮件日报专业版使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |