Email IMAP Fetch

Core Goal

• Wait for new mail with IMAP IDLE.
• Fetch unread messages after each wake-up.
• Support multiple mailbox accounts configured with env.
• Control IDLE support strictly with env mode (idle or poll) without runtime probing.
• Forward each fetched email to OpenClaw webhooks.
• Emit machine-readable JSON lines for downstream steps.
• Keep this skill strictly in stage-1 routing mode: send snippet + structured refs only, never send full raw message body, and never send attachment binary/content.

Workflow

1. Configure account env variables and OpenClaw webhook env variables (see references/env.md and assets/config.example.env).
2. Validate configuration:

python3 scripts/imap_idle_fetch.py check-config