imap-idle-sneder
使用 IMAP IDLE 保持长连接实时监听新邮件，并发送给指定飞书账号。当需要：1）监听新邮件并实时推送通知，2）建立邮件推送服务，3）替代轮询检查新邮件时使用此 skill。
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/apple133junjiang-a11y/imap-idle-senderWhat This Skill Does
imap-idle-sender is a powerful utility designed for OpenClaw that leverages the IMAP IDLE protocol to maintain a persistent connection with your email server. Unlike traditional polling methods that check for emails at fixed intervals—often leading to delays or server load—this skill remains idle until the server explicitly pushes a notification that a new message has arrived. Upon receiving this notification, the skill captures key metadata (subject, sender, date) and triggers an automated workflow to forward these details to a specified Feishu account as a formatted card message, ensuring you are notified instantly.
Installation
To integrate this skill into your environment, use the OpenClaw command-line interface. Execute the following command in your terminal:
clawhub install openclaw/skills/skills/apple133junjiang-a11y/imap-idle-sender
Once installed, navigate to the ~/.openclaw/skills/imap-idle/scripts/ directory. Open the imap_idle.py file to populate your email credentials and the destination Feishu User ID. Ensure your mailbox settings have the IMAP service enabled and that you are using an App Password or Authorization Code rather than your standard login password if required by your provider (e.g., QQ or Gmail).
Use Cases
- Real-Time Notification Systems: Ideal for users who depend on time-sensitive communication and need an immediate alert when specific emails arrive.
- Automated Alert Aggregation: Perfect for monitoring automated system reports, server logs, or invoice receipts delivered via email without keeping an email client open.
- Replacing Inefficient Polling: If you have multiple accounts to watch, this skill eliminates the need for bandwidth-heavy periodic checks, keeping your connection lightweight and responsive.
Example Prompts
- "OpenClaw, start the imap-idle-sender background process to ensure I don't miss any urgent client emails."
- "Please verify if the imap-idle-sender is currently active and monitoring my email for new incoming messages."
- "OpenClaw, update the recipient settings for the imap-idle-sender to forward all future notifications to my backup Feishu account."
Tips & Limitations
- Security: Always use dedicated application passwords for IMAP authentication to keep your primary account secure.
- Connection Stability: While the script includes automatic reconnection logic, be aware that poor network environments might disrupt the IDLE session; ensure the script is running in a persistent environment like a screen session, tmux, or a systemd service.
- Email Provider Compliance: Check your email provider's rate limits and terms of service regarding long-lived connections. Most major providers (Gmail, Outlook, QQ) support IMAP IDLE, but some corporate firewalls may aggressively terminate long-running idle sockets.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-apple133junjiang-a11y-imap-idle-sender": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api