使用 IMAP IDLE 保持长连接,实时监听新邮件并推送到指定飞书账号。适用场景:1)实时监听新邮件并推送通知;2)搭建邮件推送服务;3)替代轮询检查新邮件。
IMAP IDLE 邮件监听是一项面向实际任务的技能,主要用于使用 IMAP IDLE 模式保持长连接,实时接收服务器推送的新邮件通知;1. 运行监听脚本;
2. 配置自启动(可选);使用 OpenClaw cron 定时检查通知文件,或配置系统服务开机启。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
使用 IMAP IDLE 模式保持长连接,实时接收服务器推送的新邮件通知。
python ~/.openclaw/skills/imap-idle/scripts/imap_idle.py
脚本会在后台保持运行,收到新邮件时:
~/.openclaw/workspace/mail_notifications.json使用 OpenClaw cron 定时检查通知文件,或配置系统服务开机启动。
如需修改邮箱配置,编辑 scripts/imap_idle.py:
IMAP_SERVER = "imap.qq.com" # IMAP 服务器
IMAP_PORT = 993 # 端口
EMAIL = "你的邮箱@qq.com" # 邮箱账号
PASSWORD = "你的授权码" # 授权码
mail_notifications.json 内容示例:
[
{
"subject": "邮件主题",
"from": {
"name": "发件人姓名",
"email": "from@example.com"
},
"date": "Thu, 26 Feb 2026 10:30:00 +0800",
"received_at": "2026-02-26T10:30:00"
}
]
新邮件到达时自动发送飞书通知(卡片消息):
飞书配置(从 openclaw.json 自动获取):
ou_febxxxxxxxxxxxxxxxx如需修改接收人,编辑 scripts/imap_idle.py 中的 FEISHU_USER_ID。