概述

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 <email> --subject <subject> --body <body>

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

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

# 从文件读取正文
email-163-com send --to <email> --subject <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" <noreply@notify.cloudflare.com>
   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

版本历史

共 2 个版本

v1.0.5 当前

2026-04-30 09:13 安全安全
v1.0.3

2026-03-28 22:56 安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)

安全，无风险

查看报告

Email 163 Com

概述

email-163-com Skill

📧 功能特性

核心功能

技术特点

🚀 快速开始

1. 安装依赖

2. 配置邮箱

3. 基本使用

📖 命令参考

发送邮件

读取邮件

文件夹管理

邮件搜索

邮件操作

附件管理

🔧 配置文件

位置

格式

💡 使用示例

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

示例 2: 查看未读邮件

示例 3: 搜索特定邮件

示例 4: 清理垃圾邮件

📋 输出格式

读取邮件

发送邮件

🔐 安全说明

授权码

配置文件权限

环境变量（可选）

🐛 故障排查

问题 1: IMAP 连接失败

问题 2: 认证失败

问题 3: 附件发送失败

📚 技术参考

🔄 更新日志

v1.0.0 (2026-02-19)

📞 支持

版本历史

安全检测

腾讯云安全 (Keen)

腾讯云安全 (Sanbu)

🔗 相关推荐

imap-smtp-email

Ollama Updater

Himalaya