Email Channel for OpenClaw

Email channel plugin for OpenClaw using IMAP IDLE for real-time receiving and SMTP for sending.

Features

• Real-time email receiving via IMAP IDLE (push notifications)
• SMTP sending for agent replies
• Thread tracking using standard email headers (References, In-Reply-To)
• Multi-account support - one email per agent
• Attachment handling - downloads and passes to agent
• HTML to Markdown conversion for email content
• Whitelist support for controlling allowed senders
• Automatic reconnection with exponential backoff

Configuration

Single Account (Default)

channels:
  email:
    enabled: true
    email: "[email protected]"
    password: "${EMAIL_PASSWORD}"
    allowFrom:
      - "[email protected]"
      - "*.trusted-domain.com"

Multi-Account

channels:
  email:
    enabled: true
    defaultAccount: "agent-1"
    accounts:
      agent-1:
        email: "[email protected]"
        password: "${AGENT1_PASSWORD}"
        allowFrom:
          - "*@example.com"
      agent-2:
        email: "[email protected]"
        password: "${AGENT2_PASSWORD}"
        imapHost: "imap.163.com"
        smtpHost: "smtp.163.com"

Configuration Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | enabled | boolean | false | Enable email channel | | email | string | - | Email address (default account) | | password | string | - | Email password or app password | | imapHost | string | imap.{domain} | IMAP server host | | imapPort | number | 993 | IMAP port | | smtpHost | string | smtp.{domain} | SMTP server host | | smtpPort | number | 465 | SMTP port | | allowFrom | string[] | - | Whitelist patterns |

Whitelist Patterns

• Full email: [email protected]
• Domain wildcard: *.example.com
• User wildcard: *@example.com
• Domain only: example.com

Supported Email Providers

The channel automatically derives IMAP/SMTP hosts for common providers:

• Gmail: imap.gmail.com, smtp.gmail.com
• Outlook/Hotmail: outlook.office365.com
• QQ Mail: imap.qq.com, smtp.qq.com
• 163/126 Mail: imap.163.com, smtp.163.com
• iCloud: imap.mail.me, smtp.mail.me

For custom hosts, specify imapHost and smtpHost explicitly.

Security Notes

1. Use app-specific passwords when available (Gmail, Outlook, etc.)
2. Store passwords in environment variables, not in config files
3. Use whitelist patterns to restrict senders
4. Enable DM policies for spam control

Development

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Type check
npm run type-check

License

MIT