← 返回 Skills 市场
Email Assistant
作者
codeblackhole
· GitHub ↗
· v1.1.0
1156
总下载
0
收藏
17
当前安装
2
版本数
在 OpenClaw 中安装
/install email-assistant
功能描述
多邮箱管理助手，支持 Gmail、163、QQ、Outlook、Hotmail。功能：(1) 读取收件箱并展示邮件摘要 (2) 关键词分析标记重要邮件 (3) 自动提取邮件中的日程信息并生成日历事件。适用于需要统一管理多个邮箱、避免错过重要邮件和日程的用户。
使用说明 (SKILL.md)
Email Assistant - 多邮箱管理助手
功能概览
- 多邮箱支持: Gmail、163、QQ、Outlook、Hotmail
- 邮件读取: 获取收件箱、显示摘要、搜索邮件
- 智能分析: 关键词识别重要邮件
- 日程提取: 自动从邮件中提取日程信息
支持的邮箱
| 邮箱 | 协议 | 服务器配置 |
|---|---|---|
| Gmail | OAuth2 + IMAP | imap.gmail.com:993 |
| 163 | IMAP | imap.163.com:993 |
| IMAP | imap.qq.com:993 | |
| Outlook | IMAP | outlook.office365.com:993 |
| Hotmail | IMAP | outlook.office365.com:993 |
使用方法
1. Gmail 配置
首次使用需要配置 OAuth：
# 1. 在 Google Cloud Console 创建项目
# 2. 启用 Gmail API
# 3. 创建 OAuth 2.0 客户端凭据
# 4. 下载凭据文件为 credentials.json
# 5. 首次运行会自动打开浏览器授权
运行脚本：
cd scripts
python3 gmail_client.py --credentials ../credentials.json
2. IMAP 邮箱 (163/QQ/Outlook/Hotmail)
直接运行：
python3 imap_client.py --server \x3C服务器> --email \x3C邮箱> --password \x3C密码或App密码>
3. 查看邮件
# 查看收件箱
python3 mail_parser.py --inbox
# 搜索特定邮件
python3 mail_parser.py --search "关键词"
# 分析重要邮件
python3 mail_parser.py --analyze
4. 提取日程
# 从邮件中提取日程并生成 ICS 文件
python3 scheduler.py --extract --output events.ics
脚本说明
scripts/gmail_client.py
Gmail OAuth 认证客户端。首次运行会打开浏览器进行授权，之后凭据会缓存。
scripts/imap_client.py
通用 IMAP 客户端，适用于 163、QQ、Outlook、Hotmail。使用 App Password 认证。
scripts/mail_parser.py
邮件解析器。解析纯文本/HTML 邮件，提取关键信息，分析重要性。
scripts/scheduler.py
日程提取器。从邮件中识别 iCal 附件或纯文本日程，生成标准 ICS 日历文件。
重要邮件识别
自动识别以下关键词：
- urgent, 紧急, 重要, 即时
- deadline, 截止, 期限
- meeting, 会议, 面试
- invoice, 发票, 付款, 账单
- contract, 合同, 协议
日程提取
支持格式：
- iCal 附件 (.ics)
- 纯文本日程（日期+时间+内容）
注意事项
- Gmail: 必须使用 OAuth2，密码登录已被禁用
- 163/QQ: 需开启 IMAP 并使用 App Password
- Outlook/Hotmail: 使用常规密码或 App Password
- 建议使用 App Password 而非登录密码，提高安全性
安全使用建议
This skill appears to do what it says, but review and handle credentials carefully before use: 1) Use OAuth credentials.json and app passwords as instructed; do not paste real account passwords into shared places. 2) The Gmail script runs a local OAuth server and will create a token file (token.pickle / token.json) — securely store or delete it after use. 3) Passing passwords on the CLI can expose them in shell history; prefer app passwords and transient input methods. 4) Inspect the scripts yourself before running and run them in a controlled environment (local machine or isolated container). 5) If you don't need write actions, note the Gmail client requests modify scope (it can STAR messages); remove/limit the scope if you only need read-only access.
功能分析
Type: OpenClaw Skill
Name: email-assistant
Version: 1.1.0
The email-assistant skill bundle provides legitimate multi-account email management and calendar extraction functionality. The implementation uses standard protocols and libraries (IMAP via imaplib and Gmail API via google-api-python-client) and follows security best practices by encouraging the use of OAuth2 and App Passwords. No indicators of data exfiltration, malicious execution, or prompt injection were found in the scripts (gmail_client.py, imap_client.py, mail_parser.py, scheduler.py) or documentation.
能力评估
Purpose & Capability
Name/description match the included scripts (Gmail OAuth client, generic IMAP client, mail parser, scheduler). All requested actions (fetching emails, keyword detection, extracting calendar events) are implemented by the provided files and documented in SKILL.md.
Instruction Scope
SKILL.md directs the user to run local scripts and to provide credentials via credentials.json (Gmail) or CLI args (IMAP). Instructions stay within the email/calendar domain. Note: the Gmail flow runs a local OAuth server (run_local_server on port 8080) and scripts read/write local files (credentials.json, token.pickle/token.json, output ICS/JSON).
Install Mechanism
No install specification or remote downloads are present; this is an instruction + code bundle that runs locally. No archives or external installers are fetched by the skill.
Credentials
The skill requires user email credentials/OAuth JSON and app passwords per the docs, which are appropriate for the functionality. Registry metadata lists no required env vars, but the code expects credential files and CLI-supplied passwords — the absence of declared required credentials in the registry metadata is a minor mismatch users should be aware of. The scripts cache tokens to disk (token.pickle/token.json), which are sensitive.
Persistence & Privilege
always is false and the skill does not request persistent platform privileges. It writes credential/token files locally (normal for OAuth clients) but does not modify other skills or system-wide configs.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install email-assistant - 安装完成后，直接呼叫该 Skill 的名称或使用
/email-assistant触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.1.0
Optimized description for better discoverability
v1.0.0
- 首发版本，集成多邮箱统一管理功能。
- 支持 Gmail、163、QQ、Outlook、Hotmail 邮箱收件箱读取及摘要展示。
- 智能标记重要邮件，基于关键词自动分析筛选，防止错过关键信息。
- 自动从邮件中提取日程信息，可生成标准 ICS 日历文件。
- 提供命令行脚本，分别支持 Gmail OAuth 和多种 IMAP 邮箱配置。
元数据
常见问题
Email Assistant 是什么？
多邮箱管理助手，支持 Gmail、163、QQ、Outlook、Hotmail。功能：(1) 读取收件箱并展示邮件摘要 (2) 关键词分析标记重要邮件 (3) 自动提取邮件中的日程信息并生成日历事件。适用于需要统一管理多个邮箱、避免错过重要邮件和日程的用户。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1156 次。
如何安装 Email Assistant？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install email-assistant」即可一键安装，无需额外配置。
Email Assistant 是免费的吗？
是的，Email Assistant 完全免费（开源免费），可自由下载、安装和使用。
Email Assistant 支持哪些平台？
Email Assistant 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Email Assistant？
由 codeblackhole（@codeblackhole1024）开发并维护，当前版本 v1.1.0。
推荐 Skills