Skills imap-idle-sneder

使用 IMAP IDLE 保持长连接实时监听新邮件,并发送给指定飞书账号。当需要:1)监听新邮件并实时推送通知,2)建立邮件推送服务,3)替代轮询检查新邮件时使用此 skill。

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/apple133junjiang-a11y/imap-idle-sender" ~/.claude/skills/clawdbot-skills-imap-idle-sneder && rm -rf "$T"
manifest: skills/apple133junjiang-a11y/imap-idle-sender/SKILL.md
source content

IMAP IDLE 邮件监听

使用 IMAP IDLE 模式保持长连接,实时接收服务器推送的新邮件通知。

快速开始

1. 运行监听脚本

python ~/.openclaw/skills/imap-idle/scripts/imap_idle.py

脚本会在后台保持运行,收到新邮件时:

  • 控制台打印通知
  • 写入通知文件:
    ~/.openclaw/workspace/mail_notifications.json

2. 配置自启动(可选)

使用 OpenClaw cron 定时检查通知文件,或配置系统服务开机启动。

配置修改

如需修改邮箱配置,编辑

scripts/imap_idle.py

IMAP_SERVER = "imap.qq.com"  # IMAP 服务器
IMAP_PORT = 993               # 端口
EMAIL = "你的邮箱@qq.com"      # 邮箱账号
PASSWORD = "你的授权码"        # 授权码

支持的邮箱

  • QQ 邮箱 ✓
  • Gmail(需使用 App Password)
  • Outlook
  • 其他支持 IMAP IDLE 的邮箱

通知文件格式

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"
  }
]

与飞书集成

新邮件到达时自动发送飞书通知(卡片消息):

  • 📧 显示发件人姓名和邮箱
  • 📝 显示邮件主题
  • 📄 显示邮件摘要(前200字)

飞书配置(从 openclaw.json 自动获取):

  • 发送给用户 飞书ID:
    ou_febxxxxxxxxxxxxxxxx

如需修改接收人,编辑

scripts/imap_idle.py
中的
FEISHU_USER_ID

注意事项

  • 需要邮箱开启 IMAP 服务
  • QQ/Gmail 等需要使用授权码而非登录密码
  • IDLE 超时后会自动重连