email-163-com Skill

版本: 1.0.0
创建日期: 2026-02-19
作者: OpenClaw
描述: 163 邮箱完整邮件管理工具（Python 实现）

📧 功能特性

核心功能

• ✅ 发送邮件 - 支持纯文本和 HTML 格式
• ✅ 发送附件 - 支持单个或多个附件
• ✅ 读取邮件 - 支持 IMAP ID 认证（163 邮箱要求）
• ✅ 文件夹管理 - 列出、创建、删除文件夹
• ✅ 邮件搜索 - 按发件人、主题、日期等搜索
• ✅ 邮件操作 - 删除、移动、标记已读/未读
• ✅ 附件管理 - 下载、查看附件
• ✅ 配置管理 - 邮箱配置和账户管理

技术特点

• ✅ 支持 163 邮箱 IMAP ID 扩展（RFC 2971）
• ✅ TLS/SSL 加密连接
• ✅ 支持中文主题和发件人
• ✅ 支持 HTML 邮件
• ✅ 支持多附件发送
• ✅ 命令行友好界面

🚀 快速开始

1. 安装依赖

# Python 3.6+ 已包含所需库
# 无需额外安装

2. 配置邮箱

编辑 ~/.config/email-163-com/config.json:

{
  "email": "your_email@163.com",
  "password": "your_auth_code",
  "imap_server": "imap.163.com",
  "imap_port": 993,
  "smtp_server": "smtp.163.com",
  "smtp_port": 465
}

3. 基本使用

# 查看帮助
email-163-com --help

# 读取邮件
email-163-com read

# 发送邮件
email-163-com send --to friend@example.com --subject "Hello" --body "Hi!"

# 发送附件
email-163-com send --to friend@example.com --subject "File" --attach file.pdf

# 列出文件夹
email-163-com folders

📖 命令参考

发送邮件

# 简单发送
email-163-com send --to  --subject  --body 

# 发送 HTML 邮件
email-163-com send --to  --subject  --html "
Hello
"

# 发送附件
email-163-com send --to  --subject  --attach file1.pdf --attach file2.txt

# 从文件读取正文
email-163-com send --to  --subject  --file message.txt

读取邮件

# 读取最新 5 封
email-163-com read

# 读取指定数量
email-163-com read --count 10

# 读取指定文件夹
email-163-com read --folder "已发送" --count 5

# 读取完整邮件（含正文）
email-163-com read --id 123 --full

文件夹管理

# 列出所有文件夹
email-163-com folders

# 创建文件夹
email-163-com folder create "MyFolder"

# 删除文件夹
email-163-com folder delete "MyFolder"

邮件搜索

# 按发件人搜索
email-163-com search --from "Cloudflare"

# 按主题搜索
email-163-com search --subject "verify"

# 组合搜索
email-163-com search --from "阿里云" --subject "通知" --count 10

邮件操作

# 删除邮件
email-163-com delete --id 123

# 移动邮件
email-163-com move --id 123 --to "已删除"

# 标记已读
email-163-com flag --id 123 --set seen

# 标记未读
email-163-com flag --id 123 --unset seen

附件管理

# 列出邮件附件
email-163-com attachments --id 123

# 下载附件
email-163-com attachments --id 123 --download --output ~/Downloads/

🔧 配置文件

位置

~/.config/email-163-com/config.json

格式

{
  "email": "your_email@163.com",
  "password": "your_auth_code",
  "imap_server": "imap.163.com",
  "imap_port": 993,
  "smtp_server": "smtp.163.com",
  "smtp_port": 465,
  "imap_id": {
    "name": "OpenClaw",
    "version": "1.0.0",
    "vendor": "email-163-com",
    "support_email": "support@email-163-com.skill"
  },
  "defaults": {
    "folder": "INBOX",
    "count": 5,
    "output_dir": "~/Downloads"
  }
}

💡 使用示例

示例 1: 发送日常工作邮件

email-163-com send 
  --to colleague@example.com 
  --subject "项目进度更新" 
  --file report.txt 
  --attach progress.pdf

示例 2: 查看未读邮件

email-163-com read --count 10 --unread

示例 3: 搜索特定邮件

email-163-com search 
  --from "Cloudflare" 
  --subject "verify" 
  --count 5

示例 4: 清理垃圾邮件

email-163-com search --folder "垃圾邮件" --count 100
email-163-com delete --folder "垃圾邮件" --all

📋 输出格式

读取邮件

📬 INBOX: 16 messages total

📧 From: 阿里云
   Subject: 域名信息修改成功通知
   Date: Wed, 18 Feb 2026 22:00:53
   ID: 16
   Flags: Seen
--------------------------------------------------

📧 From: "Cloudflare" 
   Subject: [Action required] Verify your email address
   Date: Wed, 18 Feb 2026 14:17:02
   ID: 15
   Flags: 
--------------------------------------------------

发送邮件

✅ Message sent successfully!
   To: friend@example.com
   Subject: Hello
   Attachments: file.pdf (1.2 MB)

🔐 安全说明

授权码

• 不要使用邮箱登录密码
• 使用 163 邮箱的"客户端授权码"
• 获取方式：登录网页版 → 设置 → POP3/SMTP/IMAP

配置文件权限

# 设置配置文件权限（仅自己可读）
chmod 600 ~/.config/email-163-com/config.json

环境变量（可选）

也可以使用环境变量代替配置文件：

export EMAIL_163_USER="your_email@163.com"
export EMAIL_163_PASS="your_auth_code"

🐛 故障排查

问题 1: IMAP 连接失败

Error: SELECT Unsafe Login

解决: 确保配置了 IMAP ID 信息（默认已配置）

问题 2: 认证失败

Error: LOGIN failed

解决: 检查授权码是否正确（不是登录密码）

问题 3: 附件发送失败

Error: Cannot attach file

解决: 检查文件路径是否正确，文件是否可读

📚 技术参考

• RFC 2971: IMAP4 ID extension
• RFC 3501: IMAP4rev1
• RFC 5322: Internet Message Format
• 163 邮箱帮助: https://help.mail.163.com/

🔄 更新日志

v1.0.0 (2026-02-19)

• ✅ 初始版本
• ✅ 支持发送邮件（文本/HTML）
• ✅ 支持发送附件
• ✅ 支持读取邮件（IMAP ID）
• ✅ 支持文件夹管理
• ✅ 支持邮件搜索
• ✅ 支持邮件操作（删除/移动/标记）
• ✅ 支持附件下载

📞 支持

• 文档: ~/.openclaw/workspace/skills/email-163-com/README.md
• 配置: ~/.config/email-163-com/config.json
• 脚本: ~/.openclaw/workspace/skills/email-163-com/main.py

首次发布: 2026-02-19
维护者: OpenClaw Team