✓ Verified 💻 Development ✓ Enhanced Data

Lel Mail

Send and read email via a combination of python and bash scripts which makes use of the main agent f

Rating: 4.7 (77 reviews)
Downloads: 4,770 downloads
Version: 1.0.0

Overview

Send and read email via a combination of python and bash scripts which makes use of the main agent for reasoning.

Complete Documentation

View Source →

Lel Mail

Important Note If Running On the Cloud/VPS

Some cloud providers explicitly disable email leading to failiure of these scripts, services like tailscale will be needed to bypass these blocks

Setup

Setting up the Config File

Create ~/.config/lel-mail/config.json:

json

[
  {
    "provider": "gmail",
    "config": {
        "smtp": {
        "server": "smtp.gmail.com", //Default url
        "port": 587 //Default port
      },
      "imap": {
        "server": "imap.gmail.com", //Default url
        "port": 993 //Default port
      }
    },
    "auth": {
      "user": "[email protected]",
      "password": "XXXX XXXX XXXX XXXX" //Gmail Requires App Specific Password Rather Than Your Normal Password
    },
    "can_send": true,
    "can_read": true
  }
]

Setting up cron job

Set up a simple cron job which runs the following command every 5 minutes with a randomised 30-90 second delay. Confirm with user the interval to be used: ``

~/.openclaw/workspace/skills/lel-mail/scripts/email_sender_daemon.sh
      text
      ## Quick Reference

### Read Email

1. Make sure config exists, if not create it with input of user
2. Reference USERS.md (or whatever USER reference file your system uses) to see what email(s) you need to check unless user explicitly defines the email(s)
3. Run the following command
    
~/.openclaw/workspace/skills/lel-mail/scripts/check_email.sh 
      text
      ### Send Email
# Note, this script does not send the data directly but sends it to a scheduler which will automatically send it in approximately 5.5 minutes
1. Make sure you have the necessary data to send the email from the user, that includes sender, recipient and body, everything else is optional
2. Run the following command
    
~/.openclaw/workspace/skills/lel-mail/scripts/email_send.sh --sender  --recipient  --subject  --body  [--cc ...] [--bcc ...]

`` Note: if using BCC/CC note that CC/BCC are comma-separated lists

3. Manage Outgoing Queue

Outgoing emails are scheduled to send with a random delay (30-90 seconds). You can list or delete these before they are sent.

List all queued emails:

bash

python3 ~/.openclaw/workspace/skills/lel-mail/scripts/manage_queue.py --list

Delete a specific email by ID:

bash

python3 ~/.openclaw/workspace/skills/lel-mail/scripts/manage_queue.py --delete <ID>

Troubleshooting

Prompt user to assist when errors occur due to missing/invalid credentials/configuration

If emails aren't sending at all check that a cron job for the daemon is running

Installation

Terminal bash


openclaw install lel-mail

Copied!

💻Code Examples

Create `~/.config/lel-mail/config.json`:

create-configlel-mailconfigjson.json

[
  {
    "provider": "gmail",
    "config": {
        "smtp": {
        "server": "smtp.gmail.com", //Default url
        "port": 587 //Default port
      },
      "imap": {
        "server": "imap.gmail.com", //Default url
        "port": 993 //Default port
      }
    },
    "auth": {
      "user": "[email protected]",
      "password": "XXXX XXXX XXXX XXXX" //Gmail Requires App Specific Password Rather Than Your Normal Password
    },
    "can_send": true,
    "can_read": true
  }
]

example.txt

## Quick Reference

### Read Email

1. Make sure config exists, if not create it with input of user
2. Reference USERS.md (or whatever USER reference file your system uses) to see what email(s) you need to check unless user explicitly defines the email(s)
3. Run the following command

example.txt

### Send Email
# Note, this script does not send the data directly but sends it to a scheduler which will automatically send it in approximately 5.5 minutes
1. Make sure you have the necessary data to send the email from the user, that includes sender, recipient and body, everything else is optional
2. Run the following command