purelymail

# PurelyMail Setup for Clawdbot Set up email for your Clawdbot agent using [PurelyMail](https://purelymail.com) - 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: ```bash 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](https://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 ```bash purelymail config --email agent@yourdomain.com --password "YourPassword" ``` Outputs JSON to add to your `clawdbot.json`: ```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 ```bash purelymail test --email agent@yourdomain.com --password "YourPassword" ``` Tests IMAP and SMTP connectivity. ### 4. Send Test Email ```bash purelymail send-test --email agent@yourdomain.com --password "YourPassword" --to you@example.com ``` ### 5. Check Inbox ```bash 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)