name: gotoemail
version: 1.0.1
emoji: "📧"
homepage: https://github.com/feixuelingcloud/gotoemail
description: 绑定邮箱账户并管理邮件。支持 163/126/QQ/雅虎邮箱（IMAP/SMTP+授权码）、Gmail（IMAP+App密码）、企业邮箱（自定义IMAP/SMTP服务器，端口可配）。不支持需要 OAuth 的邮箱（Outlook/M365/iCloud）。触发词：绑定邮箱、添加邮箱、配置邮箱、读邮件、查收邮件、发邮件、bind email、setup email、connect mailbox。
metadata:
openclaw:
requires:
bins: [python]

GoToEmail

绑定流程

第一步：确认邮箱类型

⚡ 推荐（授权码方式）
  1. 163邮箱 / 126邮箱 / yeah.net
  2. QQ邮箱 / Foxmail

其他方式
  3. Gmail              — App 密码
  4. 雅虎邮箱 (Yahoo)   — App 密码
  5. 企业邮箱           — 自定义 IMAP/SMTP

❌ 不支持：Outlook / M365 / iCloud（OAuth 类，请在宿主应用中配置）

第二步：引导获取授权码

授权码/App密码获取步骤见 references/providers.md 的「授权码获取指南」节。

第三步：收集凭据

• 163 / QQ / Yahoo / Gmail：邮箱地址 + 授权码/App密码
• 企业邮箱：额外收集 IMAP服务器、IMAP端口（默认993）、SMTP服务器、SMTP端口（默认465）

第四步：测试连接

通过 stdin 传入 JSON 运行脚本：

echo '{"email":"user@163.com","password":"授权码"}' | python scripts/test_connection.py

企业邮箱需额外传入自定义服务器：

echo '{"email":"user@corp.com","password":"pass","imap_host":"imap.corp.com","smtp_host":"smtp.corp.com"}' | python scripts/test_connection.py

• 返回 {"ok":true,...} → 绑定成功，告知用户并保存配置
• 返回 {"ok":false,"error":"..."} → 根据错误信息排查（见 references/providers.md 错误处理节）

邮件操作

获取邮件列表

echo '{"email":"...","password":"...","imap_host":"imap.163.com","imap_port":993,"folder":"INBOX","limit":20,"unread_only":false}' | python scripts/list_emails.py

返回字段：uid、subject、from、date、unread

读取单封邮件

echo '{"email":"...","password":"...","imap_host":"imap.163.com","uid":"1234","mark_as_read":true}' | python scripts/read_email.py

返回字段：subject、from、to、date、body（纯文本）、attachments

发送邮件

echo '{"email":"...","password":"...","smtp_host":"smtp.163.com","smtp_port":465,"to":"收件人@example.com","subject":"主题","body":"正文内容"}' | python scripts/send_email.py

to 接受字符串或列表；可选字段：cc、bcc、html_body

服务器快速参考

| 提供商 | IMAP 服务器:端口 | SMTP 服务器:端口 |
|--------|----------------|----------------|
| 163邮箱 | imap.163.com:993 | smtp.163.com:465 |
| 126邮箱 | imap.126.com:993 | smtp.126.com:465 |
| QQ邮箱 | imap.qq.com:993 | smtp.qq.com:465 |
| Gmail | imap.gmail.com:993 | smtp.gmail.com:465 |
| 雅虎 | imap.mail.yahoo.com:993 | smtp.mail.yahoo.com:465 |

企业邮箱：用户自定义，全程 SSL/TLS。

👉 完整授权码获取步骤与错误排查见 references/providers.md