← Back to Skills Marketplace
Email Assistant
by
codeblackhole
· GitHub ↗
· v1.1.0
1156
Downloads
0
Stars
17
Active Installs
2
Versions
Install in OpenClaw
/install email-assistant
Description
多邮箱管理助手，支持 Gmail、163、QQ、Outlook、Hotmail。功能：(1) 读取收件箱并展示邮件摘要 (2) 关键词分析标记重要邮件 (3) 自动提取邮件中的日程信息并生成日历事件。适用于需要统一管理多个邮箱、避免错过重要邮件和日程的用户。
README (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 而非登录密码，提高安全性
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install email-assistant - After installation, invoke the skill by name or use
/email-assistant - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Optimized description for better discoverability
v1.0.0
- 首发版本，集成多邮箱统一管理功能。
- 支持 Gmail、163、QQ、Outlook、Hotmail 邮箱收件箱读取及摘要展示。
- 智能标记重要邮件，基于关键词自动分析筛选，防止错过关键信息。
- 自动从邮件中提取日程信息，可生成标准 ICS 日历文件。
- 提供命令行脚本，分别支持 Gmail OAuth 和多种 IMAP 邮箱配置。
Metadata
Frequently Asked Questions
What is Email Assistant?
多邮箱管理助手，支持 Gmail、163、QQ、Outlook、Hotmail。功能：(1) 读取收件箱并展示邮件摘要 (2) 关键词分析标记重要邮件 (3) 自动提取邮件中的日程信息并生成日历事件。适用于需要统一管理多个邮箱、避免错过重要邮件和日程的用户。 It is an AI Agent Skill for Claude Code / OpenClaw, with 1156 downloads so far.
How do I install Email Assistant?
Run "/install email-assistant" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Email Assistant free?
Yes, Email Assistant is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Email Assistant support?
Email Assistant is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Email Assistant?
It is built and maintained by codeblackhole (@codeblackhole1024); the current version is v1.1.0.
More Skills