Ravenclaw 运营技能

类别： 邮件自动化 / 通信

描述： 操作 Ravenclaw 邮件桥接服务 —— 发送邮件、预约未来邮件、检查收件箱、管理邮件工作流。支持将 POP3 邮件转发至 Discord Webhook，并具备定时发送能力。

维护者： Ibrahim Qureshi (@ibrahimq21)

标签： email, discord, webhook, automation, smtp, pop3, scheduled

功能

• 通过 SMTP 即时发送邮件
• 预约邮件在未来指定时间发送
• 检查收件箱及未读邮件
• 手动触发收件箱检查
• 查看已预约邮件队列
• 取消已预约的邮件
• 健康状态检查与统计信息

依赖条件

本地部署（用于直接运行）

Ravenclaw 必须正在运行：

# 启动 Ravenclaw 桥接服务
cd path/to/ravenclaw
python ravenclaw.py

# 默认端口：5002

环境变量：

• RAVENCLAW_URL（可选）：Ravenclaw API 自定义地址（默认为 http://localhost:5002）

社区共享

供其他用户使用该技能时需满足：

1. 用户本地已安装 Ravenclaw
2. Ravenclaw 正在运行
3. 通过环境变量或 RAVENCLAW_URL 完成配置

命令

发送邮件

立即发送一封邮件。

指令模式：

send email to [recipient] with subject [subject] and body [body]

示例：

send email to manager@company.com with subject "Leave Request" and body "I would like to take leave tomorrow."

参数：

• recipient（必填）：收件人邮箱地址
• subject（必填）：邮件主题
• body（必填）：邮件正文内容

对应 API 调用： POST /send

预约邮件

预约一封邮件在指定时间发送。

指令模式：

schedule email to [recipient] with subject [subject] and body [body] at [time]

示例：

schedule email to hr@company.com with subject "Leave Application" and body "Requesting leave for next Monday" at "2026-02-23T09:00:00"

参数：

• recipient（必填）：收件人邮箱地址
• subject（必填）：邮件主题
• body（必填）：邮件正文内容
• time（必填）：ISO-8601 时间戳（例如：2026-02-23T09:00:00）

对应 API 调用： POST /schedule

提示：

• 推荐格式：YYYY-MM-DDTHH:MM:SS
• 预约时间必须为将来时刻
• 高优先级邮件拥有更多重试次数

列出已预约邮件

查看所有已预约的邮件。

指令模式：

list scheduled emails
show scheduled emails

对应 API 调用： GET /schedule/list

响应内容包括：

• 邮件总数
• 待发送数量
• 完整列表（含状态、目标时间、收件人）

取消已预约邮件

取消一条待发送的预约邮件。

指令模式：

cancel scheduled email [id]

示例：

cancel scheduled email sched_20260223100000_0

对应 API 调用： POST /schedule/cancel/

检查收件箱

手动触发一次收件箱检查。

指令模式：

check inbox
check emails

对应 API 调用： POST /check

行为说明：

• 从 POP3 服务器拉取新邮件
• 若已配置，则转发至 Discord
• 更新本地 inbox.json 文件

查看未读邮件

获取当前未读邮件列表。

指令模式：

show unread emails
get unread

对应 API 调用： GET /unread

查看全部收件箱

获取收件箱中全部邮件。

指令模式：

show inbox
list emails

对应 API 调用： GET /inbox

健康状态检查

检查 Ravenclaw 当前运行状态。

指令模式：

ravenclaw status
ravenclaw health

对应 API 调用： GET /health

响应内容包括：

• 运行状态
• 账户信息
• 邮件计数
• 域名配置

统计信息

查看处理相关统计信息。

指令模式：

ravenclaw stats
email statistics

对应 API 调用： GET /stats

包含内容：

• 邮件总数
• 未读数量
• 待发送预约邮件数
• 允许的域名列表

配置示例

直接运行（Ravenclaw 部署于本地）

# 无需特殊配置
# 默认使用 http://localhost:5002

自定义 URL

# 设置环境变量
export RAVENCLAW_URL="http://your-server:5002"

Ravenclaw .env 配置

# 必填项
EMAIL_HOST=mail.yourdomain.com
EMAIL_USERNAME=your@email.com
EMAIL_PASSWORD=yourpassword

# 可选项
DOMAIN_FILTER=yourdomain.com
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...
BRIDGE_PORT=5002

典型用例

请假申请

schedule email to manager@company.com with subject "Leave Request - March 2-6" and body "Dear Manager,nnI would like to request leave..." at "2026-02-16T10:00:00"

会议提醒

schedule email to team@company.com with subject "Meeting Tomorrow" and body "Don't forget about the sync meeting at 10 AM" at "2026-02-17T09:00:00"

自动通知

send email to alerts@company.com with subject "System Alert" and body "CPU usage exceeded 90%"

错误处理

故障排查

Ravenclaw 无响应：

# 检查是否运行中
curl http://localhost:5002/health

# 启动 Ravenclaw
cd path/to/ravenclaw
python ravenclaw.py

邮件未发出：

• 确认 .env 中 SMTP 凭据正确
• 确认收件人域名在 DOMAIN_FILTER 白名单中
• 查阅 ravenclaw.log 日志文件

预约邮件未发送：

• Ravenclaw 必须持续运行以支持定时发送
• 调用 /schedule/list 查看状态
• 确保 target_time 符合 ISO-8601 格式

相关文件

• SKILL.md — 本文档
• skill.yaml — 技能定义文件（如需）
• ops.sh — 辅助操作脚本（可选）

集成说明

该技能依赖以下条件：

1. Ravenclaw 服务在本地运行
2. 已在 .env 中完成 SMTP/POP3 接入配置
3. 可访问 localhost:5002 网络地址

若面向社区共享，用户需自行部署 Ravenclaw 实例，并配置其专属的邮件凭证。

相关资源

• Ravenclaw 仓库： https://github.com/ibrahimq21/ravenclaw
• 文档： 参见 Ravenclaw 仓库中的 README.md