SolEmail

Read and send emails using the SolEmail automation system. Use when asked to check emails, send files via email, respond to an email, or set up email automation.

Sol Email Skill

Automated email reading and sending via himalaya (local Maildir) and SMTP.

Scripts Location

All scripts live in ~/.openclaw/workspace/scripts/:

• agentmail-send.py — send emails
• agentmail-inbox.py — read emails
• find-zip-email.py — find files, zip, email

Prerequisites

1. himalaya installed — brew install himalaya
2. Email account configured in ~/.config/himalaya/config.toml
3. Environment variables set (see .env.example in SolEmail repo):
   • SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, FROM_NAME

Daily Use

Check recent emails

bash

python3 ~/.openclaw/workspace/scripts/agentmail-inbox.py --limit 10

Check unread emails only

bash

python3 ~/.openclaw/workspace/scripts/agentmail-inbox.py --unread-only

Read a specific email (by ID)

bash

python3 ~/.openclaw/workspace/scripts/agentmail-inbox.py --read 42

Send an email

bash

python3 ~/.openclaw/workspace/scripts/agentmail-send.py \
    --to "[e-mail]" \
    --subject "Subject here" \
    --body "Email body text"

Send with attachments

bash

python3 ~/.openclaw/workspace/scripts/agentmail-send.py \
    --to "[e-mail]" \
    --subject "Your files" \
    --body "Please find the files attached." \
    --attachment "/path/to/file1.pdf" \
    --attachment "/path/to/file2.zip"

Find files, zip, and email

bash

python3 ~/.openclaw/workspace/scripts/find-zip-email.py \
    --find "*.pdf" \
    --search-dir ~/Downloads \
    --to "[e-mail]" \
    --subject "Your PDFs" \
    --body "As requested."

Sync emails before checking

bash

himalaya sync && python3 ~/.openclaw/workspace/scripts/agentmail-inbox.py --limit 10

Configuration

himalaya account (IMAP + SMTP)

~/.config/himalaya/config.toml:

toml

[[accounts]]
name = "icloud"

[accounts.icloud.imap]
host     = "imap.mail.me.com"  # or imap.gmail.com for Gmail
port     = 993
username = "[e-mail]"
password = "xxxx-xxxx-xxxx-xxxx"  # App-specific password, NOT your real password
ssl      = true

[accounts.icloud.smtp]
host     = "smtp.mail.me.com"
port     = 587
username = "[e-mail]"
password = "xxxx-xxxx-xxxx-xxxx"
starttls = true

Environment variables

Set in ~/.openclaw/workspace/.env:

text

SMTP_HOST=smtp.mail.me.com
SMTP_PORT=587
SMTP_USER=[e-mail]
SMTP_PASSWORD=xxxx-xxxx-xxxx-xxxx
FROM_NAME=Your Name

Troubleshooting

"Authentication failed" when sending

App password is wrong or expired. Generate a new one at appleid.apple.com.

"No emails found"

Run himalaya sync first to download emails from the server.

SMTP timeout

Try port 465 (SSL) instead of 587 (STARTTLS).

himalaya not found

Install: brew install himalaya

Cron / Schedule

Set up automated email checks via OpenClaw cron:

text

name: Email check
schedule: "*/15 * * * *"
command: "himalaya sync && python3 ~/.openclaw/workspace/scripts/agentmail-inbox.py --unread-only"

Or add to HEARTBEAT.md in the workspace for heartbeat-based checking.

Related

• Full guide: https://thesolai.github.io/guides/email-automation/
• Repository: https://github.com/TheSolAI/SolEmail
• Technical report: https://github.com/TheSolAI/SolEmail/blob/main/report.md