email-163-com

Verified

Comprehensive Python tool for managing 163.com emails with sending, reading, searching, folder, and attachment handling via IMAP ID and SMTP.

601 downloads

$ Add to .claude/skills/

$ openclaw install

About This Skill

Content available in Chinese

# 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. 安装依赖

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

2. 配置邮箱

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

```json { "email": "[email protected]", "password": "your_auth_code", "imap_server": "imap.163.com", "imap_port": 993, "smtp_server": "smtp.163.com", "smtp_port": 465 } ```

3. 基本使用

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

# 读取邮件 email-163-com read

# 发送邮件 email-163-com send --to [email protected] --subject "Hello" --body "Hi!"

# 发送附件 email-163-com send --to [email protected] --subject "File" --attach file.pdf

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

---

📖 命令参考

发送邮件

```bash # 简单发送 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 ```

读取邮件

```bash # 读取最新 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 ```

文件夹管理

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

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

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

邮件搜索

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

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

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

邮件操作

```bash # 删除邮件 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 ```

附件管理

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

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

---

🔧 配置文件

位置

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

格式

```json { "email": "[email protected]", "password": "KZtfcUWCKGNFf9M9", "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": "[email protected]" }, "defaults": { "folder": "INBOX", "count": 5, "output_dir": "~/Downloads" } } ```

---

💡 使用示例

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

```bash email-163-com send \ --to [email protected] \ --subject "项目进度更新" \ --file report.txt \ --attach progress.pdf ```

示例 2: 查看未读邮件

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

示例 3: 搜索特定邮件

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

示例 4: 清理垃圾邮件

```bash 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" <[email protected]> Subject: [Action required] Verify your email address Date: Wed, 18 Feb 2026 14:17:02 ID: 15 Flags: -------------------------------------------------- ```

发送邮件

``` ✅ Message sent successfully! To: [email protected] Subject: Hello Attachments: file.pdf (1.2 MB) ```

---

🔐 安全说明

授权码

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

配置文件权限

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

环境变量（可选）

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

```bash export EMAIL_163_USER="[email protected]" export EMAIL_163_PASS="KZtfcUWCKGNFf9M9" ```

---

🐛 故障排查

问题 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/email.py`

---

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

Use Cases

Send and receive emails through NetEase 163 email accounts programmatically
Automate email notifications through 163.com SMTP for Chinese users
Monitor 163 email inbox for incoming messages matching specific criteria
Send bulk emails through 163.com accounts for notification workflows
Integrate 163 email capabilities into agent-driven communication pipelines

Pros & Cons

Pros

+Native integration with 163.com, one of China's most popular email services
+SMTP-based sending is reliable and well-supported
+Programmatic access enables automated email workflows

Cons

-Documentation primarily in Chinese
-Only available on claude-code and openclaw platforms
-163.com only — not applicable to Gmail, Outlook, or other email providers

FAQ

What does email-163-com do?

Comprehensive Python tool for managing 163.com emails with sending, reading, searching, folder, and attachment handling via IMAP ID and SMTP.

What platforms support email-163-com?

email-163-com is available on Claude Code, OpenClaw.

What are the use cases for email-163-com?

Send and receive emails through NetEase 163 email accounts programmatically. Automate email notifications through 163.com SMTP for Chinese users. Monitor 163 email inbox for incoming messages matching specific criteria.

100+ free AI tools

Writing, PDF, image, and developer tools — all in your browser.

AI Humanizer

Make AI text undetectable

AI Detector

Free, unlimited

PDF Tools

Merge, split, compress

Next Step

Use the skill detail page to evaluate fit and install steps. For a direct browser workflow, move into a focused tool route instead of staying in broader support surfaces.

Open Free Tools Try AI Detector