139mail（非官方）

v1.0.4

139邮箱IMAP/POP3操作技能。支持通过IMAP/POP3协议查看收件箱/未读邮件、发送邮件、搜索邮件、管理邮件、邮件分拣。首次使用需配置账号和授权码。当用户需要操作139邮箱（mail.10086.cn）时触发此技能。

⭐ 0· 555·2 current·2 all-time

by@fanjiabo-529

Security Scan

VirusTotal

Benign

View report →

OpenClaw

Benign

medium confidence

✓

Purpose & Capability

Name/description, scripts, and docs are coherent: the scripts implement IMAP/SMTP operations (view/search/send/manage/move) and require the mailbox username and an authorization code. No unrelated environment variables, binaries, or external services are requested.

ℹ

Instruction Scope

Runtime instructions legitimately ask the user to provide their 139邮箱 account and authorization code and to run the included scripts. The skill prompts the agent/user for credentials and instructs saving them to a local JSON config file. It also recommends and uses SSL compatibility measures (unverified SSL context and reduced security level) and suggests setting PYTHONHTTPSVERIFY=0 for debugging — these weaken TLS certificate validation and are explicit risks called out in the docs.

✓

Install Mechanism

No install spec in registry; user is instructed to pip install imapclient (a known Python package). No downloads from arbitrary URLs or archive extraction are present.

ℹ

Credentials

The only sensitive data required is the mailbox username and authorization code, which is appropriate for an email client. Credentials are stored in a local JSON config file (config/139mail.conf) in plaintext; the code attempts to chmod the file to 0o600 but this is best-effort and may not be effective on Windows. No other credentials or unrelated environment variables are requested.

✓

Persistence & Privilege

Skill does not request always:true or other elevated platform privileges. It creates/reads its own config file under the skill's config directory and does not modify other skills or system-wide agent settings.

Assessment

This skill appears to do what it says (manage a 139 mailbox via IMAP/SMTP), but you should consider the following before installing or using it: - It requires your 139 mailbox address and the 16‑character authorization code; the agent may ask you to paste these in chat if you follow the provided prompt. Prefer entering credentials locally (running the provided config_manager.py) instead of typing them into an open chat whenever possible. - Credentials are stored in a plaintext JSON file (config/139mail.conf). The script tries to chmod the file to 600, but that may not be enforced on Windows. If you care about secrecy, store credentials in a secure credential store or limit filesystem access to that file. - The code disables normal certificate verification (ssl._create_unverified_context()) and lowers OpenSSL security level to connect to an old TLS server. This is acknowledged in the docs but reduces transport security and makes man‑in‑the‑middle attacks easier. Only use this on trusted networks, and avoid running it on untrusted/public Wi‑Fi. - If you only need short‑term access, consider creating an authorization code and revoking it after use. Review and run the scripts in an isolated environment (e.g., a VM or dedicated container) if you are unsure. If you want stronger guarantees, ask the author to implement certified TLS verification fallback, encrypt the config on disk or integrate with OS credential stores, and avoid recommending PYTHONHTTPSVERIFY=0.

Like a lobster shell, security has layers — review code before you run it.

latestvk970wtaayfaxpqb6n7ypvat9m182aaza

555downloads

0stars

4versions

Updated 1mo ago

v1.0.4

MIT-0

⚠️ 重要声明

本技能非 139 邮箱官方发布

本技能由 139 邮箱发烧友基于标准 IMAP/POP3 协议开发，旨在为 OpenClaw 用户提供便捷的 139 邮箱访问方式。

注意事项：

本技能为非官方第三方工具

使用本技能产生的风险与 139 邮箱官方无关

请用户谨慎使用，妥善保管账号密码

建议定期更换邮箱授权码以确保安全

使用前请确保：

您已了解并接受上述声明

您已开启 139 邮箱的 IMAP/POP3 服务

您已生成邮箱授权码（非登录密码）

name: 139mail description: 139邮箱IMAP/POP3操作技能。支持通过IMAP/POP3协议查看收件箱/未读邮件、发送邮件、搜索邮件、管理邮件、邮件分拣。首次使用需配置账号和授权码。当用户需要操作139邮箱（mail.10086.cn）时触发此技能。

139邮箱IMAP/POP3操作技能

概述

本技能通过IMAP/POP3协议直接连接139邮箱服务器，实现高效的邮件管理功能。

重要：首次使用需配置账号和授权码

安装依赖

本技能需要安装第三方依赖库：

pip install imapclient

依赖说明：

imapclient：用于IMAP协议连接139邮箱服务器
标准库：smtplib, email, json, argparse（Python内置）

SSL/TLS 安全说明

由于139邮箱服务器使用的是较旧版本的TLS协议（TLS 1.0/1.1），本技能使用兼容模式连接。 安全建议：

兼容模式会降低SSL安全性，建议仅在受信任的网络环境中使用

首次使用流程

当用户首次请求操作139邮箱时：

第1步：环境检查（推荐）

运行环境检查脚本，确保所有依赖就绪：

python scripts/check_env.py

此脚本会检查：

Python版本 >= 3.8
OpenSSL版本 >= 1.1.1
imapclient模块已安装
SSL兼容性设置
配置文件是否存在

第2步：安装依赖

pip install imapclient

第3步：开启IMAP服务并获取授权码

前往 https://mail.10086.cn/ 登录邮箱
进入 设置 → 账户 → IMAP/POP3服务
开启 IMAP/SMTP服务
获取授权码（16位字符串，不是登录密码！）

⚠️ 重要：授权码只显示一次，请务必保存！

第4步：保存配置

python scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password 你的授权码

第5步：测试连接

python scripts/check_mail.py --limit 5

如果显示邮件列表，说明配置成功！

快速开始（一步完成）

# 1. 安装依赖
pip install imapclient

# 2. 运行环境检查
python scripts/check_env.py

# 3. 配置账号（替换为你的账号和授权码）
python scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password xxxxxxxxxxxxxxxx

# 4. 查看邮件
python scripts/check_mail.py --unread

配置管理

脚本：scripts/config_manager.py

命令：

python scripts/config_manager.py check - 检查是否已配置
python scripts/config_manager.py save --username <账号> --password <授权码> - 保存配置
python scripts/config_manager.py show - 显示当前配置（隐藏授权码）

配置文件：config/139mail.conf

配置文件格式（JSON）：

{
  "username": "136xxxxxxxxx@139.com",
  "password": "授权码",
  "imap_server": "imap.139.com",
  "imap_port": 993,
  "smtp_server": "smtp.139.com",
  "smtp_port": 465
}

项目结构

skills/139mail/
├── SKILL.md                    # 本文件 - 使用文档
├── config/                     # 配置目录
│   └── 139mail.conf           # 账号配置文件（自动创建）
├── references/                 # 参考资料
│   ├── credentials.md         # 服务器配置信息
│   └── imap_guide.md          # IMAP操作指南
└── scripts/                    # 核心脚本
    ├── check_env.py           # ⭐ 环境检查脚本（新手先用）
    ├── config_manager.py      # 配置管理
    ├── check_mail.py          # 查看邮件
    ├── view_mail.py           # 查看邮件详情
    ├── send_mail.py           # 发送邮件
    ├── search_mail.py         # 搜索邮件
    ├── manage_mail.py         # 邮件管理（标记/删除）
    └── move_mail.py           # 邮件分拣

核心功能

1. 查看收件箱/未读邮件

触发场景："查看139邮箱"、"有没有新邮件"

流程：

检查配置是否存在（config_manager.py check）
如无配置，执行首次使用流程
调用 scripts/check_mail.py --unread

命令示例：

python scripts/check_mail.py --limit 10
python scripts/check_mail.py --unread

2. 查看指定邮件详情

脚本：scripts/view_mail.py <邮件ID>

示例：

python scripts/view_mail.py 123

3. 发送邮件

脚本：scripts/send_mail.py <收件人> <主题> <正文>

示例：

python scripts/send_mail.py "recipient@example.com" "主题" "正文内容"

4. 搜索邮件

脚本：scripts/search_mail.py <关键词>

示例：

python scripts/search_mail.py "工作汇报"

5. 管理邮件

脚本：scripts/manage_mail.py

常用命令：

# 列出邮件
python scripts/manage_mail.py --list

# 列出已删除邮件
python scripts/manage_mail.py --list-trash

# 标记已读/未读
python scripts/manage_mail.py --mark-read <ID>
python scripts/manage_mail.py --mark-unread <ID>

# 删除邮件（移动到已删除文件夹）
python scripts/manage_mail.py --delete <ID>

# 恢复邮件（从已删除文件夹恢复）
python scripts/manage_mail.py --restore <ID>

# 彻底删除（永久删除，不可恢复）
python scripts/manage_mail.py --permanent-delete <ID>

6. 邮件分拣

脚本：scripts/move_mail.py

示例：

# 列出所有文件夹
python scripts/move_mail.py --list-folders

# 移动邮件
python scripts/move_mail.py --move <邮件ID> --to <目标文件夹>

错误处理与故障排除

常见错误及解决方案

1. SSL握手失败

错误信息：

[SSL: SSLV3_ALERT_HANDSHAKE_FAILURE] sslv3 alert handshake failure

原因：

139邮箱使用较旧的TLS 1.0/1.1协议
Python 3.10+ 默认OpenSSL安全级别过高

解决方案：本技能已自动配置兼容性设置，无需手动修改。如仍失败：

# 检查Python版本
python --version  # 需要 >= 3.8

# 检查OpenSSL版本
python -c "import ssl; print(ssl.OPENSSL_VERSION)"  # 需要 >= 1.1.1

2. 登录失败

错误信息：

imapclient.exceptions.LoginError

检查清单：

账号格式正确：136xxxxxxxxx@139.com（不是纯手机号）
使用的是授权码，不是登录密码
已在网页版开启 IMAP 服务
授权码未过期（如过期需重新获取）

3. 找不到模块

错误信息：

ModuleNotFoundError: No module named 'imapclient'

解决：

pip install imapclient

4. 中文显示乱码

现象：邮件主题/发件人显示为乱码

原因：Windows终端编码问题

解决：

使用 VS Code 终端（推荐）
或设置 Windows 使用 UTF-8：
```
chcp 65001
```

调试模式

如需详细调试信息，可在运行脚本前设置环境变量：

set PYTHONHTTPSVERIFY=0
python scripts/check_mail.py --limit 5

首次使用提示模板

当检测到用户未配置时，使用以下提示：

首次使用139邮箱功能，需要您先完成以下设置：

1. 安装依赖：
   pip install imapclient

2. 登录 https://mail.10086.cn/
3. 进入 设置 → 账户 → IMAP/POP3服务
4. 开启 IMAP/POP3 服务
5. 获取授权码（不是登录密码！）

请提供：
- 139邮箱账号（如 136xxxxxxxxx@139.com）
- 授权码：______

安全说明

配置文件权限：配置文件 config/139mail.conf 保存时设置权限为 600（仅所有者可读写）
SSL/TLS：使用兼容模式连接139邮箱。由于139邮箱使用较旧TLS协议，此模式会降低SSL安全性，建议仅在受信任的网络环境中使用。
授权码保护：授权码仅保存在本地配置文件，不会上传到任何外部服务器。
使用完成后：如不再使用，建议删除配置文件并撤销邮箱授权码。

参考文档

IMAP操作指南：参见 references/imap_guide.md
服务器配置：参见 references/credentials.md

Comments

Loading comments...