Full Mail

完整邮件功能 - 支持发送 (SMTP) 和接收 (IMAP) 邮件

LegionSpace-Hackathon@legionspace-hackathon

Install

openclaw skills install @legionspace-hackathon/full-mail

Full Mail - 完整邮件功能

支持发送邮件 (SMTP) 和接收邮件 (IMAP) 的完整邮件技能。

配置

在 ~/.openclaw/openclaw.json 中配置：

json

{
  "skills": {
    "entries": {
      "full-mail": {
        "enabled": true,
        "env": {
          "EMAIL_SMTP_SERVER": "smtp.163.com",
          "EMAIL_SMTP_PORT": "465",
          "EMAIL_IMAP_SERVER": "imap.163.com",
          "EMAIL_IMAP_PORT": "993",
          "EMAIL_USER": "your-email@163.com",
          "EMAIL_PASSWORD": "授权码或应用密码"
        }
      }
    }
  }
}

配置参数

参数	说明	示例
EMAIL_SMTP_SERVER	SMTP 服务器地址	smtp.163.com
EMAIL_SMTP_PORT	SMTP 端口 (SSL:465, TLS:587)	465
EMAIL_IMAP_SERVER	IMAP 服务器地址	imap.163.com
EMAIL_IMAP_PORT	IMAP 端口 (SSL:993)	993
EMAIL_USER	邮箱账号	your-email@163.com
EMAIL_PASSWORD	授权码/应用密码	ABC123DEF456

常用邮箱服务器配置

邮箱	SMTP 服务器	SMTP 端口	IMAP 服务器	IMAP 端口
163 邮箱	smtp.163.com	465	imap.163.com	993
126 邮箱	smtp.126.com	465	imap.126.com	993
QQ 邮箱	smtp.qq.com	465	imap.qq.com	993
Gmail	smtp.gmail.com	587	imap.gmail.com	993
Outlook	smtp.office365.com	587	outlook.office365.com	993
新浪邮箱	smtp.sina.com	465	imap.sina.com	993

使用方法

发送邮件

bash

# 纯文本邮件
python3 ~/.openclaw/workspace/skills/full-mail/send_email.py "收件人" "主题" "正文"

# 带附件
python3 ~/.openclaw/workspace/skills/full-mail/send_email.py "收件人" "主题" "正文" "/path/to/file.pdf"

# 多个收件人 (逗号分隔)
python3 ~/.openclaw/workspace/skills/full-mail/send_email.py "a@x.com,b@y.com" "主题" "正文"

接收邮件

bash

# 查看收件箱最新 10 封邮件
python3 ~/.openclaw/workspace/skills/full-mail/read_email.py list 10

# 查看指定邮件 (按序号)
python3 ~/.openclaw/workspace/skills/full-mail/read_email.py read 1

# 搜索邮件
python3 ~/.openclaw/workspace/skills/full-mail/read_email.py search "关键词"

# 下载附件
python3 ~/.openclaw/workspace/skills/full-mail/read_email.py attachments 1

# 标记已读
python3 ~/.openclaw/workspace/skills/full-mail/read_email.py markread 1

# 删除邮件
python3 ~/.openclaw/workspace/skills/full-mail/read_email.py delete 1

授权码获取

163/QQ 邮箱

登录邮箱网页版
设置 → 账户/POP3/SMTP/IMAP
开启 SMTP/IMAP 服务
生成授权码 (需短信验证)

Gmail

开启两步验证
访问 https://myaccount.google.com/apppasswords
生成应用密码

故障排查

认证失败：检查 EMAIL_PASSWORD 是否为授权码 (非登录密码)
连接失败：检查服务器地址和端口
收件箱为空：检查 IMAP 配置是否正确