smart-email
Email assistant skill — check emails, AI summaries, daily digests. Supports Gmail, Outlook/M365, Google Workspace. Users interact through their chat platform (Telegram, Feishu, WhatsApp, etc.).
- License 许可
- MIT
- 最近更新
- 2026-06-10
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- smart-email
- homepage
- https://clawhub.ai/skills/smart-email
- metadata
- { "clawdbot": { "emoji": "📧", "install": [ { "id": "npm", "cwd": "__skill__", "kind": "npm", "label": "Install dependencies" } ], "requires": { "bins": [ "node" ] } } }
- description
- Email assistant skill — check emails, AI summaries, daily digests. Supports Gmail, Outlook/M365, Google Workspace. Users interact through their chat platform (Telegram, Feishu, WhatsApp, etc.).
03 SKILL.md 正文
Smart Email — 邮件助手
让用户通过聊天(Telegram / 飞书 / WhatsApp)管理邮箱,查看邮件,获取 AI 摘要和每日日报。
用户可以说什么(意图识别)
当用户发送以下类型的消息时,使用此 skill:
| 用户说的话 | 执行的命令 |
|---|---|
| "查邮件" / "有新邮件吗" / "check email" | check --summarize |
| "查看 xxx@gmail.com 的邮件" | check --summarize --account xxx@gmail.com |
| "最近3天的邮件" | check --summarize --since 4320 |
| "邮件日报" / "今天邮件总结" / "email digest" | digest |
| "读一下这封邮件" + uid | read <uid> |
| "添加邮箱" / "设置邮箱" / "setup email" | → 引导 setup 流程 |
| "删除邮箱 xxx" | remove xxx@gmail.com |
| "我有哪些邮箱" / "邮箱列表" | accounts |
| "设置 API Key" / "配置 AI" | → 引导 config 流程 |
CLI
所有命令通过此路径执行,输出 JSON:
node <SKILL_DIR>/cli.js <command> [options]
<SKILL_DIR> 是此 skill 的安装目录。
命令参考
check — 查看新邮件
node <SKILL_DIR>/cli.js check [--summarize] [--account EMAIL] [--since MINUTES] [--max N]
--summarize— 包含 AI 摘要(推荐默认开启)--since M— 回看 M 分钟(默认 60)--max N— 最多返回 N 封(默认 10)--account EMAIL— 只查指定邮箱
输出示例:
{
"emails": [
{
"account": "user@gmail.com",
"uid": "12345",
"from": "Boss",
"subject": "Q1 Report",
"date": "2026-03-12T10:00:00Z",
"bodyPreview": "Please review...",
"summary": "🔴 老板要你审核 Q1 报告,需要尽快回复"
}
],
"total": 1
}
格式化回复建议:按邮件逐条展示,包含发件人、主题、AI摘要。标注重要程度。
read — 读取邮件全文
node <SKILL_DIR>/cli.js read <uid> [--account EMAIL]
返回邮件全文 + AI 解读。
digest — 邮件日报
node <SKILL_DIR>/cli.js digest [--since MINUTES] [--account EMAIL]
--since M— 回看时间(默认 1440 = 24小时)
返回 AI 生成的邮件总结,按紧急/关注/可忽略分类。
accounts — 查看已配置邮箱
node <SKILL_DIR>/cli.js accounts
setup — 添加邮箱
# Gmail / Google Workspace
node <SKILL_DIR>/cli.js setup <email> --password <APP_PASSWORD>
# Outlook / M365 (OAuth2)
node <SKILL_DIR>/cli.js setup <email> --auth oauth
# Outlook / M365 (App Password)
node <SKILL_DIR>/cli.js setup <email> --auth password --password <APP_PASSWORD>
引导用户的流程:
- 问用户邮箱地址
- 自动检测类型(Gmail / Outlook / Workspace)
- 如果是 Gmail/Workspace:
- 告诉用户需要 App Password
- 指导:Google 账户 → 安全性 → 两步验证 → 应用专用密码
- 用户提供后执行 setup
- 如果是 Outlook/M365:
- 推荐 OAuth2(更安全,不需要密码)
- 执行
setup <email> --auth oauth,会返回一个链接和验证码 - 告诉用户在浏览器打开链接、输入验证码
- 等待授权完成
- 其他邮箱:问用户密码/App Password
remove — 删除邮箱
node <SKILL_DIR>/cli.js remove <email>
config — 配置
# 查看当前配置
node <SKILL_DIR>/cli.js config
# 设置 AI API Key(必需,用于邮件摘要)
node <SKILL_DIR>/cli.js config ai_api_key <KEY>
# 设置 API 地址和模型(可选)
node <SKILL_DIR>/cli.js config ai_api_base https://api.deepseek.com
node <SKILL_DIR>/cli.js config ai_model deepseek-chat
# Microsoft OAuth2 配置(Outlook 用户需要)
node <SKILL_DIR>/cli.js config ms_client_id <CLIENT_ID>
node <SKILL_DIR>/cli.js config ms_tenant_id <TENANT_ID>
Web UI(可选)
提供浏览器界面,适合不喜欢命令行的用户:
node <SKILL_DIR>/server.js [--port 3900]
启动后会显示带 token 的 URL,打开即可在浏览器中配置和使用。
首次使用检查
当用户第一次使用邮件相关功能时,检查:
accounts是否有已配置邮箱?没有 → 引导 setupconfig是否有ai_api_key?没有 → 提示需要配置 AI Key(否则没有摘要功能)
数据存储
- 邮箱凭证:
<SKILL_DIR>/data/email.db(SQLite,本地加密存储) - 配置:
<SKILL_DIR>/data/config.json - 所有数据仅存在用户本地,不上传
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
touchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
teams-meeting-pipeline
Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.