Sol Email 技能

通过 himalaya（本地 Maildir）和 SMTP 实现邮件的自动读取与发送。

脚本位置

所有脚本均位于 ~/.openclaw/workspace/scripts/ 目录下：

• agentmail-send.py — 发送邮件
• agentmail-inbox.py — 读取邮件
• find-zip-email.py — 查找文件、打包为 ZIP 并邮件发送

前置依赖

1. 已安装 himalaya — brew install himalaya
2. 已在 ~/.config/himalaya/config.toml 中配置邮箱账户
3. 已设置环境变量（参见 SolEmail 仓库中的 .env.example）：
   • SMTP_HOST、SMTP_PORT、SMTP_USER、SMTP_PASSWORD、FROM_NAME

日常使用

查看最近的邮件

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

仅查看未读邮件

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

阅读指定 ID 的某封邮件

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

发送一封邮件

python3 ~/.openclaw/workspace/scripts/agentmail-send.py 
    --to "recipient@example.com" 
    --subject "Subject here" 
    --body "Email body text"

带附件发送邮件

python3 ~/.openclaw/workspace/scripts/agentmail-send.py 
    --to "recipient@example.com" 
    --subject "Your files" 
    --body "Please find the files attached." 
    --attachment "/path/to/file1.pdf" 
    --attachment "/path/to/file2.zip"

查找文件 → 打包为 ZIP → 邮件发送

python3 ~/.openclaw/workspace/scripts/find-zip-email.py 
    --find "*.pdf" 
    --search-dir ~/Downloads 
    --to "recipient@example.com" 
    --subject "Your PDFs" 
    --body "As requested."

检查前先同步邮件

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

配置

himalaya 账户（IMAP + SMTP）

~/.config/himalaya/config.toml 示例：

[[accounts]]
name = "icloud"

[accounts.icloud.imap]
host     = "imap.mail.me.com"  # Gmail 可使用 imap.gmail.com
port     = 993
username = "yourname@icloud.com"
password = "xxxx-xxxx-xxxx-xxxx"  # 应用专用密码，非您的主密码
ssl      = true

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

环境变量

在 ~/.openclaw/workspace/.env 中设置：

SMTP_HOST=smtp.mail.me.com
SMTP_PORT=587
SMTP_USER=yourname@icloud.com
SMTP_PASSWORD=xxxx-xxxx-xxxx-xxxx
FROM_NAME=Your Name

故障排查

发送时提示 “Authentication failed”（认证失败）

应用专用密码错误或已过期。请前往 appleid.apple.com 重新生成。

提示 “No emails found”（未找到邮件）

请先运行 himalaya sync，从服务器下载邮件。

SMTP 连接超时

尝试将端口由 587（STARTTLS）更换为 465（SSL）。

提示 “himalaya not found”（找不到 himalaya）

请安装： brew install himalaya

Cron / 定时任务

可通过 OpenClaw cron 设置自动邮件检查：

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

或添加至工作区的 HEARTBEAT.md 文件中，以实现基于心跳机制的检查。

相关资源

• 完整指南： https://thesolai.github.io/guides/email-automation/
• 代码仓库： https://github.com/TheSolAI/SolEmail
• 技术报告： https://github.com/TheSolAI/SolEmail/blob/main/report.md