PurelyMail Setup for Clawdbot

Set up email for your Clawdbot agent using PurelyMail - a simple, privacy-focused email service perfect for agent inboxes.

Why PurelyMail?

• Cheap: ~$10/year for unlimited addresses
• Simple: No bloat, just email
• Privacy: Based in US, minimal data retention
• Reliable: Great deliverability
• Agent-friendly: Easy IMAP/SMTP setup

Quick Start (Wizard)

The easiest way to set up is with the interactive wizard:

purelymail wizard

The wizard will:

1. ✓ Check if you have a PurelyMail account
2. ✓ Test your IMAP/SMTP connection
3. ✓ Generate clawdbot.json config
4. ✓ Optionally send a test email

Manual Setup

1. Create PurelyMail Account

1. Go to purelymail.com and sign up
2. Add your domain (or use their subdomain)
3. Create a mailbox for your agent (e.g., agent@yourdomain.com)
4. Note the password

2. Generate Clawdbot Config

purelymail config --email agent@yourdomain.com --password "YourPassword"

Outputs JSON to add to your clawdbot.json:

{
  "skills": {
    "entries": {
      "agent-email": {
        "env": {
          "AGENT_EMAIL": "agent@yourdomain.com",
          "AGENT_EMAIL_PASSWORD": "YourPassword",
          "AGENT_IMAP_SERVER": "imap.purelymail.com",
          "AGENT_SMTP_SERVER": "smtp.purelymail.com"
        }
      }
    }
  }
}

3. Test Connection

purelymail test --email agent@yourdomain.com --password "YourPassword"

Tests IMAP and SMTP connectivity.

4. Send Test Email

purelymail send-test --email agent@yourdomain.com --password "YourPassword" --to you@example.com

5. Check Inbox

purelymail inbox --email agent@yourdomain.com --password "YourPassword" --limit 5

Commands

Command	Description
config	Generate clawdbot.json config snippet
test	Test IMAP/SMTP connectivity
send-test	Send a test email
inbox	List recent inbox messages
read	Read a specific email
setup-guide	Print full setup instructions

Environment Variables

Once configured in clawdbot.json, these env vars are available:

• AGENT_EMAIL - The email address
• AGENT_EMAIL_PASSWORD - The password
• AGENT_IMAP_SERVER - IMAP server (imap.purelymail.com)
• AGENT_SMTP_SERVER - SMTP server (smtp.purelymail.com)

PurelyMail Settings

Setting	Value
IMAP Server	imap.purelymail.com
IMAP Port	993 (SSL)
SMTP Server	smtp.purelymail.com
SMTP Port	465 (SSL) or 587 (STARTTLS)
Auth	Email + Password

Tips

• Use a strong, unique password for your agent
• Consider creating a dedicated domain for agent emails
• PurelyMail supports catch-all addresses (great for routing)
• Enable 2FA on your PurelyMail account (use app password for agent)