How to Connect OpenClaw to Email

# Gmail: Settings → See all settings → Forwarding and POP/IMAP → Enable IMAP
# Outlook: Settings → Mail → Sync email → POP and IMAP → Enable IMAP
# Self-hosted: Check your mail server documentation

# Gmail:
# 1. Go to myaccount.google.com/apppasswords
# 2. Select app: "Other" → name it "OpenClaw"
# 3. Copy the 16-character password
#
# Outlook / Microsoft 365:
# 1. Go to account.microsoft.com/security
# 2. Select "Advanced security options"
# 3. Under "App passwords", create a new one
# 4. Copy the generated password

# In config/channels/email.yaml:
email:
  enabled: true
  imap:
    host: "imap.gmail.com"      # or imap-mail.outlook.com
    port: 993
    tls: true
    username: "bot@example.com"
    password: "YOUR_APP_PASSWORD"
    folder: "INBOX"             # Folder to monitor
    idle: true                  # Use IMAP IDLE if supported
    poll_interval: 60           # Fallback poll interval in seconds
  smtp:
    host: "smtp.gmail.com"      # or smtp-mail.outlook.com
    port: 587
    tls: starttls               # or "tls" for port 465
    username: "bot@example.com"
    password: "YOUR_APP_PASSWORD"
  from_name: "OpenClaw AI"
  reply_prefix: "[OpenClaw]"    # Subject prefix for replies

# In config/channels/email.yaml (continued):
filters:
  allowed_senders: []          # Empty = all senders, or list addresses
  blocked_senders:
    - "noreply@*"              # Ignore no-reply addresses
    - "mailer-daemon@*"        # Ignore bounce messages
  subject_filters:
    include: []                # Only process matching subjects
    exclude:
      - "Out of Office"        # Skip auto-replies
      - "Undeliverable"        # Skip bounce notices
  max_age_hours: 24            # Ignore emails older than this

# In config/channels/email.yaml (continued):
safety:
  max_replies_per_thread: 5    # Stop replying after N messages in a thread
  cooldown_seconds: 30         # Minimum time between replies to same sender
  skip_auto_replies: true      # Ignore emails with Auto-Submitted header
  add_headers:
    X-Auto-Reply: "OpenClaw"   # Mark outgoing emails to prevent loops
    Auto-Submitted: "auto-replied"

# Send a test email to your configured address
# Check OpenClaw logs:
tail -f ~/.openclaw/logs/channels.log | grep email

# Verify IMAP connection:
openclaw channel test email --verbose