purelymail_skill

Overview

This skill sets up and validates PurelyMail email accounts for Clawdbot agents so agents can send, receive, and monitor mail. It generates Clawdbot config snippets, verifies IMAP/SMTP connectivity, and offers commands to send test messages and inspect the inbox. The workflow is designed for fast interactive setup or scripted/manual configuration.

How this skill works

The skill uses PurelyMail credentials to generate environment variables for clawdbot.json and then runs network checks against imap.purelymail.com and smtp.purelymail.com. It can run an interactive wizard that auto-detects accounts, runs IMAP/SMTP tests, and optionally sends a test email. Additional commands list recent messages, read specific emails, and output a ready-to-use config snippet.

When to use it

• Provision a dedicated inbox for a Clawdbot agent during deployment
• Validate IMAP and SMTP connectivity before launching agents
• Generate safe, environment-ready config entries for clawdbot.json
• Troubleshoot agent email delivery or mailbox access issues
• Run quick manual checks or automated CI tests for email functionality

Best practices

• Use a strong, unique password or an app-specific password for the agent
• Prefer a dedicated domain or catch-all mailbox to isolate agent traffic
• Store credentials in environment variables, not in source code
• Test both IMAP (993 SSL) and SMTP (465 SSL or 587 STARTTLS) before production
• Limit inbox polling frequency to reduce rate limits and resource use

Example use cases

• Interactive setup: run the wizard to create config and send a verification email
• CI/CD check: run the test command in pipelines to ensure mail connectivity
• Mail monitoring: list recent messages to confirm agents receive tasks
• Migration: generate new clawdbot.json entries when moving agents to PurelyMail
• Troubleshooting: read specific emails to debug inbound parsing or routing