Email Setup
Email Setup
Email integration allows your AI employee to send and receive emails. This is ideal for formal communications, customer support, and automated responses.
PicoClaw only. Email is not available for Moltis employees. If you need email capabilities, use a PicoClaw employee.
What You'll Need
- An email account (Gmail, Outlook, or custom domain)
- SMTP and IMAP server details
- ~20 minutes for setup
Configuration Fields
Email uses the following fields:
| Field | Description |
|---|---|
| The email address (used for both sending and login) | |
| password | Email password or app password |
| smtp_host | Outgoing mail server hostname |
| smtp_port | SMTP port (usually 587 for TLS or 465 for SSL) |
| imap_host | Incoming mail server hostname |
| imap_port | IMAP port (usually 993 for SSL) |
| allow_from | Comma-separated email addresses allowed to contact the bot (leave empty to allow all) |
Gmail Setup
Gmail is the most common email provider. Follow these steps for Gmail configuration.
Step 1: Enable 2-Factor Authentication
Gmail requires app passwords, which need 2FA enabled first.
- Go to Google Account Security
- Find 2-Step Verification
- Follow the prompts to enable it
Step 2: Create App Password
- Go to Google App Passwords
- Select Mail as the app
- Select your device
- Click Generate
- Copy the 16-character password
Important: Save this password! You won't be able to see it again.
Step 3: Configure in MakersFuel
Use these settings for Gmail:
| Field | Value |
|---|---|
| Your Gmail address | |
| password | The app password (not your regular password) |
| smtp_host | smtp.gmail.com |
| smtp_port | 587 |
| imap_host | imap.gmail.com |
| imap_port | 993 |
Outlook/Microsoft 365 Setup
Step 1: Enable SMTP/IMAP
- Go to Outlook Settings
- Navigate to Mail -> Sync email
- Enable POP and IMAP
Step 2: App Password (if 2FA enabled)
- Go to Microsoft Security
- Create an app password for Mail
Step 3: Configure in MakersFuel
| Field | Value |
|---|---|
| Your Outlook address | |
| password | Your password or app password |
| smtp_host | smtp.office365.com |
| smtp_port | 587 |
| imap_host | outlook.office365.com |
| imap_port | 993 |
Custom Domain Setup
For professional use, configure your own domain's email.
Get SMTP/IMAP Details
Contact your email hosting provider or find settings in your email dashboard.
Common fields needed:
| Field | Example |
|---|---|
| smtp_host | mail.yourdomain.com |
| smtp_port | 587 or 465 |
| imap_host | mail.yourdomain.com |
| imap_port | 993 |
Email Authentication
For better deliverability, configure:
| Record | Purpose |
|---|---|
| SPF | Authorize sending servers |
| DKIM | Email signature verification |
| DMARC | Policy for failed checks |
Note: Without proper authentication, your emails may be marked as spam.
Configuration in MakersFuel
Add Email Channel
- Go to your employee's configuration page
- Find the Channels section
- Click Add Channel or enable Email
Enter Settings
Fill in the six required fields:
| Field | Description |
|---|---|
| Your email address | |
| password | Email password or app password |
| smtp_host | Outgoing mail server |
| smtp_port | Usually 587 (TLS) or 465 (SSL) |
| imap_host | Incoming mail server |
| imap_port | Usually 993 (SSL) |
Access Control
Use the allow_from field to restrict which email addresses can interact with the bot:
| Setting | Description |
|---|---|
| Specific senders | Comma-separated email addresses |
| All senders | Leave empty (responds to anyone) |
Save
- Click Save to apply the configuration
- The employee will begin monitoring the inbox
Features
Supported Actions
| Action | Supported |
|---|---|
| Read emails | Yes |
| Send replies | Yes |
| Send new emails | Yes |
| Attachments | Yes |
| HTML formatting | Yes |
| Threading | Yes |
Email Processing
Your employee can:
- Parse email content and attachments
- Extract information from emails
- Generate contextual responses
- Follow up on conversations
Troubleshooting
"Authentication failed"
- Check credentials -- Verify email and password
- Use app password -- Regular passwords may not work with Gmail/Outlook
- Enable access -- Some providers block "less secure apps"
- Check 2FA -- May require app password
"Connection refused"
- Verify host -- Check smtp_host and imap_host values
- Check port -- Try alternative ports (587, 465, 993)
- Check firewall -- Ensure ports are open
- Try different encryption -- SSL vs TLS
"Emails not being received"
- Check IMAP settings -- Verify imap_host and imap_port are correct
- Check allow_from -- May be filtering out the sender
- Check spam -- Emails may be in spam folder
"Emails going to spam"
- Configure SPF -- Add SPF record to DNS
- Configure DKIM -- Set up email signing
- Configure DMARC -- Add DMARC policy
- Warm up domain -- Gradually increase volume
"Slow responses"
Email is checked periodically, not in real-time:
- Default check interval: Every few minutes
- Consider other channels for urgent communication
Best Practices
| Practice | Why |
|---|---|
| Use dedicated email | Separates bot from personal email |
| Configure authentication | Improves deliverability |
| Set clear expectations | Email is not instant |
| Monitor spam reports | Maintain sender reputation |
Security Considerations
| Consideration | Recommendation |
|---|---|
| Password storage | Use app passwords, not main password |
| Access scope | Create limited-access account if possible |
| Monitoring | Review sent emails periodically |
| Sensitive data | Be careful with attachments |
Next Steps
- Employee Channels Overview -- Learn about other channels
- Other Platforms -- Matrix, LINE, and more
- Tools & Skills -- Extend capabilities
What did you think of this content?