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

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

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)