email-163-com Skill

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

📧 功能特性

核心功能

技术特点

🚀 快速开始

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": "newolf20000@163.com",
  "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": "newolf20000@163.com"
  },
  "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)

🔐 安全说明

授权码

配置文件权限

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

环境变量（可选）

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

export EMAIL_163_USER="newolf20000@163.com"
export EMAIL_163_PASS="KZtfcUWCKGNFf9M9"

🐛 故障排查

问题 1: IMAP 连接失败

Error: SELECT Unsafe Login

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

问题 2: 认证失败

Error: LOGIN failed

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

问题 3: 附件发送失败

Error: Cannot attach file

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

📚 技术参考

🔄 更新日志

v1.0.0 (2026-02-19)

📞 支持

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