{
  "schemaVersion": "1.0",
  "item": {
    "slug": "139mail",
    "name": "139mail",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/FANJIABO-529/139mail",
    "canonicalUrl": "https://clawhub.ai/FANJIABO-529/139mail",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/139mail",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=139mail",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/check_env.py",
      "scripts/check_mail.py",
      "scripts/config_manager.py",
      "scripts/manage_mail.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/139mail"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/139mail",
    "agentPageUrl": "https://openagent3.xyz/skills/139mail/agent",
    "manifestUrl": "https://openagent3.xyz/skills/139mail/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/139mail/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "⚠️ 重要声明",
        "body": "本技能非 139 邮箱官方发布\n本技能由 139 邮箱发烧友基于标准 IMAP/POP3 协议开发，旨在为 OpenClaw 用户提供便捷的 139 邮箱访问方式。\n注意事项：\n\n本技能为非官方第三方工具\n使用本技能产生的风险与 139 邮箱官方无关\n请用户谨慎使用，妥善保管账号密码\n建议定期更换邮箱授权码以确保安全\n\n使用前请确保：\n\n您已了解并接受上述声明\n您已开启 139 邮箱的 IMAP/POP3 服务\n您已生成邮箱授权码（非登录密码）"
      },
      {
        "title": "概述",
        "body": "本技能通过IMAP/POP3协议直接连接139邮箱服务器，实现高效的邮件管理功能。\n\n重要：首次使用需配置账号和授权码"
      },
      {
        "title": "安装依赖",
        "body": "本技能需要安装第三方依赖库：\n\npip install imapclient\n\n依赖说明：\n\nimapclient：用于IMAP协议连接139邮箱服务器\n标准库：smtplib, email, json, argparse（Python内置）"
      },
      {
        "title": "SSL/TLS 安全说明",
        "body": "由于139邮箱服务器使用的是较旧版本的TLS协议（TLS 1.0/1.1），本技能使用兼容模式连接。\n安全建议：\n\n兼容模式会降低SSL安全性，建议仅在受信任的网络环境中使用"
      },
      {
        "title": "首次使用流程",
        "body": "当用户首次请求操作139邮箱时："
      },
      {
        "title": "第1步：环境检查（推荐）",
        "body": "运行环境检查脚本，确保所有依赖就绪：\n\npython scripts/check_env.py\n\n此脚本会检查：\n\nPython版本 >= 3.8\nOpenSSL版本 >= 1.1.1\nimapclient模块已安装\nSSL兼容性设置\n配置文件是否存在"
      },
      {
        "title": "第2步：安装依赖",
        "body": "pip install imapclient"
      },
      {
        "title": "第3步：开启IMAP服务并获取授权码",
        "body": "前往 https://mail.10086.cn/ 登录邮箱\n进入 设置 → 账户 → IMAP/POP3服务\n开启 IMAP/SMTP服务\n获取授权码（16位字符串，不是登录密码！）\n\n⚠️ 重要：授权码只显示一次，请务必保存！"
      },
      {
        "title": "第4步：保存配置",
        "body": "python scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password 你的授权码"
      },
      {
        "title": "第5步：测试连接",
        "body": "python scripts/check_mail.py --limit 5\n\n如果显示邮件列表，说明配置成功！"
      },
      {
        "title": "快速开始（一步完成）",
        "body": "# 1. 安装依赖\npip install imapclient\n\n# 2. 运行环境检查\npython scripts/check_env.py\n\n# 3. 配置账号（替换为你的账号和授权码）\npython scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password xxxxxxxxxxxxxxxx\n\n# 4. 查看邮件\npython scripts/check_mail.py --unread"
      },
      {
        "title": "配置管理",
        "body": "脚本：scripts/config_manager.py\n\n命令：\n\npython scripts/config_manager.py check - 检查是否已配置\npython scripts/config_manager.py save --username <账号> --password <授权码> - 保存配置\npython scripts/config_manager.py show - 显示当前配置（隐藏授权码）\n\n配置文件：config/139mail.conf\n\n配置文件格式（JSON）：\n\n{\n  \"username\": \"136xxxxxxxxx@139.com\",\n  \"password\": \"授权码\",\n  \"imap_server\": \"imap.139.com\",\n  \"imap_port\": 993,\n  \"smtp_server\": \"smtp.139.com\",\n  \"smtp_port\": 465\n}"
      },
      {
        "title": "项目结构",
        "body": "skills/139mail/\n├── SKILL.md                    # 本文件 - 使用文档\n├── config/                     # 配置目录\n│   └── 139mail.conf           # 账号配置文件（自动创建）\n├── references/                 # 参考资料\n│   ├── credentials.md         # 服务器配置信息\n│   └── imap_guide.md          # IMAP操作指南\n└── scripts/                    # 核心脚本\n    ├── check_env.py           # ⭐ 环境检查脚本（新手先用）\n    ├── config_manager.py      # 配置管理\n    ├── check_mail.py          # 查看邮件\n    ├── view_mail.py           # 查看邮件详情\n    ├── send_mail.py           # 发送邮件\n    ├── search_mail.py         # 搜索邮件\n    ├── manage_mail.py         # 邮件管理（标记/删除）\n    └── move_mail.py           # 邮件分拣"
      },
      {
        "title": "1. 查看收件箱/未读邮件",
        "body": "触发场景：\"查看139邮箱\"、\"有没有新邮件\"\n\n流程：\n\n检查配置是否存在（config_manager.py check）\n如无配置，执行首次使用流程\n调用 scripts/check_mail.py --unread\n\n命令示例：\n\npython scripts/check_mail.py --limit 10\npython scripts/check_mail.py --unread"
      },
      {
        "title": "2. 查看指定邮件详情",
        "body": "脚本：scripts/view_mail.py <邮件ID>\n\n示例：\n\npython scripts/view_mail.py 123"
      },
      {
        "title": "3. 发送邮件",
        "body": "脚本：scripts/send_mail.py <收件人> <主题> <正文>\n\n示例：\n\npython scripts/send_mail.py \"recipient@example.com\" \"主题\" \"正文内容\""
      },
      {
        "title": "4. 搜索邮件",
        "body": "脚本：scripts/search_mail.py <关键词>\n\n示例：\n\npython scripts/search_mail.py \"工作汇报\""
      },
      {
        "title": "5. 管理邮件",
        "body": "脚本：scripts/manage_mail.py\n\n常用命令：\n\n# 列出邮件\npython scripts/manage_mail.py --list\n\n# 列出已删除邮件\npython scripts/manage_mail.py --list-trash\n\n# 标记已读/未读\npython scripts/manage_mail.py --mark-read <ID>\npython scripts/manage_mail.py --mark-unread <ID>\n\n# 删除邮件（移动到已删除文件夹）\npython scripts/manage_mail.py --delete <ID>\n\n# 恢复邮件（从已删除文件夹恢复）\npython scripts/manage_mail.py --restore <ID>\n\n# 彻底删除（永久删除，不可恢复）\npython scripts/manage_mail.py --permanent-delete <ID>"
      },
      {
        "title": "6. 邮件分拣",
        "body": "脚本：scripts/move_mail.py\n\n示例：\n\n# 列出所有文件夹\npython scripts/move_mail.py --list-folders\n\n# 移动邮件\npython scripts/move_mail.py --move <邮件ID> --to <目标文件夹>"
      },
      {
        "title": "常见错误及解决方案",
        "body": "1. SSL握手失败\n\n错误信息：\n\n[SSL: SSLV3_ALERT_HANDSHAKE_FAILURE] sslv3 alert handshake failure\n\n原因：\n\n139邮箱使用较旧的TLS 1.0/1.1协议\nPython 3.10+ 默认OpenSSL安全级别过高\n\n解决方案：\n本技能已自动配置兼容性设置，无需手动修改。如仍失败：\n\n# 检查Python版本\npython --version  # 需要 >= 3.8\n\n# 检查OpenSSL版本\npython -c \"import ssl; print(ssl.OPENSSL_VERSION)\"  # 需要 >= 1.1.1\n\n2. 登录失败\n\n错误信息：\n\nimapclient.exceptions.LoginError\n\n检查清单：\n\n账号格式正确：136xxxxxxxxx@139.com（不是纯手机号）\n 使用的是授权码，不是登录密码\n 已在网页版开启 IMAP 服务\n 授权码未过期（如过期需重新获取）\n\n3. 找不到模块\n\n错误信息：\n\nModuleNotFoundError: No module named 'imapclient'\n\n解决：\n\npip install imapclient\n\n4. 中文显示乱码\n\n现象：邮件主题/发件人显示为乱码\n\n原因：Windows终端编码问题\n\n解决：\n\n使用 VS Code 终端（推荐）\n或设置 Windows 使用 UTF-8：\nchcp 65001"
      },
      {
        "title": "调试模式",
        "body": "如需详细调试信息，可在运行脚本前设置环境变量：\n\nset PYTHONHTTPSVERIFY=0\npython scripts/check_mail.py --limit 5"
      },
      {
        "title": "首次使用提示模板",
        "body": "当检测到用户未配置时，使用以下提示：\n\n首次使用139邮箱功能，需要您先完成以下设置：\n\n1. 安装依赖：\n   pip install imapclient\n\n2. 登录 https://mail.10086.cn/\n3. 进入 设置 → 账户 → IMAP/POP3服务\n4. 开启 IMAP/POP3 服务\n5. 获取授权码（不是登录密码！）\n\n请提供：\n- 139邮箱账号（如 136xxxxxxxxx@139.com）\n- 授权码：______"
      },
      {
        "title": "安全说明",
        "body": "配置文件权限：配置文件 config/139mail.conf 保存时设置权限为 600（仅所有者可读写）\nSSL/TLS：使用兼容模式连接139邮箱。由于139邮箱使用较旧TLS协议，此模式会降低SSL安全性，建议仅在受信任的网络环境中使用。\n授权码保护：授权码仅保存在本地配置文件，不会上传到任何外部服务器。\n使用完成后：如不再使用，建议删除配置文件并撤销邮箱授权码。"
      },
      {
        "title": "参考文档",
        "body": "IMAP操作指南：参见 references/imap_guide.md\n服务器配置：参见 references/credentials.md"
      }
    ],
    "body": "⚠️ 重要声明\n\n本技能非 139 邮箱官方发布\n\n本技能由 139 邮箱发烧友基于标准 IMAP/POP3 协议开发，旨在为 OpenClaw 用户提供便捷的 139 邮箱访问方式。\n\n注意事项：\n\n本技能为非官方第三方工具\n使用本技能产生的风险与 139 邮箱官方无关\n请用户谨慎使用，妥善保管账号密码\n建议定期更换邮箱授权码以确保安全\n\n使用前请确保：\n\n您已了解并接受上述声明\n您已开启 139 邮箱的 IMAP/POP3 服务\n您已生成邮箱授权码（非登录密码）\nname: 139mail description: 139邮箱IMAP/POP3操作技能。支持通过IMAP/POP3协议查看收件箱/未读邮件、发送邮件、搜索邮件、管理邮件、邮件分拣。首次使用需配置账号和授权码。当用户需要操作139邮箱（mail.10086.cn）时触发此技能。\n139邮箱IMAP/POP3操作技能\n概述\n\n本技能通过IMAP/POP3协议直接连接139邮箱服务器，实现高效的邮件管理功能。\n\n重要：首次使用需配置账号和授权码\n\n安装依赖\n\n本技能需要安装第三方依赖库：\n\npip install imapclient\n\n\n依赖说明：\n\nimapclient：用于IMAP协议连接139邮箱服务器\n标准库：smtplib, email, json, argparse（Python内置）\nSSL/TLS 安全说明\n\n由于139邮箱服务器使用的是较旧版本的TLS协议（TLS 1.0/1.1），本技能使用兼容模式连接。 安全建议：\n\n兼容模式会降低SSL安全性，建议仅在受信任的网络环境中使用\n首次使用流程\n\n当用户首次请求操作139邮箱时：\n\n第1步：环境检查（推荐）\n\n运行环境检查脚本，确保所有依赖就绪：\n\npython scripts/check_env.py\n\n\n此脚本会检查：\n\nPython版本 >= 3.8\nOpenSSL版本 >= 1.1.1\nimapclient模块已安装\nSSL兼容性设置\n配置文件是否存在\n第2步：安装依赖\npip install imapclient\n\n第3步：开启IMAP服务并获取授权码\n前往 https://mail.10086.cn/ 登录邮箱\n进入 设置 → 账户 → IMAP/POP3服务\n开启 IMAP/SMTP服务\n获取授权码（16位字符串，不是登录密码！）\n\n⚠️ 重要：授权码只显示一次，请务必保存！\n\n第4步：保存配置\npython scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password 你的授权码\n\n第5步：测试连接\npython scripts/check_mail.py --limit 5\n\n\n如果显示邮件列表，说明配置成功！\n\n快速开始（一步完成）\n# 1. 安装依赖\npip install imapclient\n\n# 2. 运行环境检查\npython scripts/check_env.py\n\n# 3. 配置账号（替换为你的账号和授权码）\npython scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password xxxxxxxxxxxxxxxx\n\n# 4. 查看邮件\npython scripts/check_mail.py --unread\n\n配置管理\n\n脚本：scripts/config_manager.py\n\n命令：\n\npython scripts/config_manager.py check - 检查是否已配置\npython scripts/config_manager.py save --username <账号> --password <授权码> - 保存配置\npython scripts/config_manager.py show - 显示当前配置（隐藏授权码）\n\n配置文件：config/139mail.conf\n\n配置文件格式（JSON）：\n\n{\n  \"username\": \"136xxxxxxxxx@139.com\",\n  \"password\": \"授权码\",\n  \"imap_server\": \"imap.139.com\",\n  \"imap_port\": 993,\n  \"smtp_server\": \"smtp.139.com\",\n  \"smtp_port\": 465\n}\n\n项目结构\nskills/139mail/\n├── SKILL.md                    # 本文件 - 使用文档\n├── config/                     # 配置目录\n│   └── 139mail.conf           # 账号配置文件（自动创建）\n├── references/                 # 参考资料\n│   ├── credentials.md         # 服务器配置信息\n│   └── imap_guide.md          # IMAP操作指南\n└── scripts/                    # 核心脚本\n    ├── check_env.py           # ⭐ 环境检查脚本（新手先用）\n    ├── config_manager.py      # 配置管理\n    ├── check_mail.py          # 查看邮件\n    ├── view_mail.py           # 查看邮件详情\n    ├── send_mail.py           # 发送邮件\n    ├── search_mail.py         # 搜索邮件\n    ├── manage_mail.py         # 邮件管理（标记/删除）\n    └── move_mail.py           # 邮件分拣\n\n核心功能\n1. 查看收件箱/未读邮件\n\n触发场景：\"查看139邮箱\"、\"有没有新邮件\"\n\n流程：\n\n检查配置是否存在（config_manager.py check）\n如无配置，执行首次使用流程\n调用 scripts/check_mail.py --unread\n\n命令示例：\n\npython scripts/check_mail.py --limit 10\npython scripts/check_mail.py --unread\n\n2. 查看指定邮件详情\n\n脚本：scripts/view_mail.py <邮件ID>\n\n示例：\n\npython scripts/view_mail.py 123\n\n3. 发送邮件\n\n脚本：scripts/send_mail.py <收件人> <主题> <正文>\n\n示例：\n\npython scripts/send_mail.py \"recipient@example.com\" \"主题\" \"正文内容\"\n\n4. 搜索邮件\n\n脚本：scripts/search_mail.py <关键词>\n\n示例：\n\npython scripts/search_mail.py \"工作汇报\"\n\n5. 管理邮件\n\n脚本：scripts/manage_mail.py\n\n常用命令：\n\n# 列出邮件\npython scripts/manage_mail.py --list\n\n# 列出已删除邮件\npython scripts/manage_mail.py --list-trash\n\n# 标记已读/未读\npython scripts/manage_mail.py --mark-read <ID>\npython scripts/manage_mail.py --mark-unread <ID>\n\n# 删除邮件（移动到已删除文件夹）\npython scripts/manage_mail.py --delete <ID>\n\n# 恢复邮件（从已删除文件夹恢复）\npython scripts/manage_mail.py --restore <ID>\n\n# 彻底删除（永久删除，不可恢复）\npython scripts/manage_mail.py --permanent-delete <ID>\n\n6. 邮件分拣\n\n脚本：scripts/move_mail.py\n\n示例：\n\n# 列出所有文件夹\npython scripts/move_mail.py --list-folders\n\n# 移动邮件\npython scripts/move_mail.py --move <邮件ID> --to <目标文件夹>\n\n错误处理与故障排除\n常见错误及解决方案\n1. SSL握手失败\n\n错误信息：\n\n[SSL: SSLV3_ALERT_HANDSHAKE_FAILURE] sslv3 alert handshake failure\n\n\n原因：\n\n139邮箱使用较旧的TLS 1.0/1.1协议\nPython 3.10+ 默认OpenSSL安全级别过高\n\n解决方案： 本技能已自动配置兼容性设置，无需手动修改。如仍失败：\n\n# 检查Python版本\npython --version  # 需要 >= 3.8\n\n# 检查OpenSSL版本\npython -c \"import ssl; print(ssl.OPENSSL_VERSION)\"  # 需要 >= 1.1.1\n\n2. 登录失败\n\n错误信息：\n\nimapclient.exceptions.LoginError\n\n\n检查清单：\n\n 账号格式正确：136xxxxxxxxx@139.com（不是纯手机号）\n 使用的是授权码，不是登录密码\n 已在网页版开启 IMAP 服务\n 授权码未过期（如过期需重新获取）\n3. 找不到模块\n\n错误信息：\n\nModuleNotFoundError: No module named 'imapclient'\n\n\n解决：\n\npip install imapclient\n\n4. 中文显示乱码\n\n现象：邮件主题/发件人显示为乱码\n\n原因：Windows终端编码问题\n\n解决：\n\n使用 VS Code 终端（推荐）\n或设置 Windows 使用 UTF-8：\nchcp 65001\n\n调试模式\n\n如需详细调试信息，可在运行脚本前设置环境变量：\n\nset PYTHONHTTPSVERIFY=0\npython scripts/check_mail.py --limit 5\n\n首次使用提示模板\n\n当检测到用户未配置时，使用以下提示：\n\n首次使用139邮箱功能，需要您先完成以下设置：\n\n1. 安装依赖：\n   pip install imapclient\n\n2. 登录 https://mail.10086.cn/\n3. 进入 设置 → 账户 → IMAP/POP3服务\n4. 开启 IMAP/POP3 服务\n5. 获取授权码（不是登录密码！）\n\n请提供：\n- 139邮箱账号（如 136xxxxxxxxx@139.com）\n- 授权码：______\n\n安全说明\n配置文件权限：配置文件 config/139mail.conf 保存时设置权限为 600（仅所有者可读写）\nSSL/TLS：使用兼容模式连接139邮箱。由于139邮箱使用较旧TLS协议，此模式会降低SSL安全性，建议仅在受信任的网络环境中使用。\n授权码保护：授权码仅保存在本地配置文件，不会上传到任何外部服务器。\n使用完成后：如不再使用，建议删除配置文件并撤销邮箱授权码。\n参考文档\nIMAP操作指南：参见 references/imap_guide.md\n服务器配置：参见 references/credentials.md"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/FANJIABO-529/139mail",
    "publisherUrl": "https://clawhub.ai/FANJIABO-529/139mail",
    "owner": "FANJIABO-529",
    "version": "1.0.4",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/139mail",
    "downloadUrl": "https://openagent3.xyz/downloads/139mail",
    "agentUrl": "https://openagent3.xyz/skills/139mail/agent",
    "manifestUrl": "https://openagent3.xyz/skills/139mail/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/139mail/agent.md"
  }
}