# Mailbox

当用户需要任何邮箱/邮件操作时使用此技能, , 包括查看、阅读、搜索、发送、回复、转发、整理或删除邮件，管理会话线程，绑定个人邮箱或注册新邮箱。此技能是邮件任务的统一且唯一入口，通...

- Repository: https://github.com/agentscope-ai/QwenPaw (37135 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentscope-ai/QwenPaw --skill mailbox -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/QwenPaw --skill mailbox -g -a codex -y`
Cursor: `npx skills add agentscope-ai/QwenPaw --skill mailbox -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/QwenPaw --skill mailbox -g -a gemini-cli -y`

## Description

当用户需要任何邮箱/邮件操作时使用此技能, , 包括查看、阅读、搜索、发送、回复、转发、整理或删除邮件，管理会话线程，绑定个人邮箱或注册新邮箱。此技能是邮件任务的统一且唯一入口，通过 qwenpawmail-mcp 编排操作，当前支持 9 个个人邮箱域名。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 邮箱操作 (qwenpawmail-mcp)

使用 **qwenpawmail-mcp** 绑定或注册邮箱并执行邮件操作。

## 支持的邮箱服务商

QwenPaw 托管邮箱流程当前支持以下 9 个邮箱域名：

| 服务商 | 域名 | 登录凭据 |
| --- | --- | --- |
| 网易 | `163.com`、`126.com`、`yeah.net` | 16 位授权码 |
| 腾讯 | `qq.com`、`foxmail.com` | 16 位授权码 |
| 新浪 | `sina.com`、`sina.cn` | 16 位授权码 |
| 阿里 | `aliyun.com` | 邮箱登录密码；仅支持已有账号 |
| Google | `gmail.com` | 开启两步验证后生成的 16 位应用专用密码 |

当前托管流程不支持企业邮箱、自定义域名和 Microsoft 邮箱。

`create_mailbox` 仅为 `163.com`、`126.com`、`yeah.net`、`qq.com` 和 `foxmail.com` 提供内置注册引导。其他受支持域名需走服务商官方注册流程。`aliyun.com` 已关闭个人邮箱新注册，只能绑定已有账号。

## 调用规则

任何邮件操作都必须从此技能进入。不要自行编造其他邮件流程，也不要绕过 qwenpawmail-mcp 直接执行原始 IMAP/SMTP 命令。

## 凭据与配置模型

`agent.json` 只保存公开邮箱配置。`mail` 的预期结构为：

```json
{
  "mail": {
    "is_new_account": false,
    "credential": {
      "name": "myaccount",
      "domain": "163.com",
      "provider": ""
    },
    "push": {
      "mode": "off",
      "rules": [],
      "poll_interval_seconds": 120,
      "access_control_enabled": false
    }
  }
}
```

敏感字段 `auth_code`、`password` 和 `phone_number` 会被刻意排除在 `agent.json` 之外，Agent API 响应也不会返回它们。服务商凭据统一通过 `auth_code` 表示，配置后会被加密保存；注册密码和手机号只在对应邮箱的注册网页内填写，当前 QwenPaw 流程不会保存。公开配置中看不到 `auth_code` 并不表示用户没有配置凭据。

QwenPaw 仅在运行时通过托管 DriverCard 解析加密的服务商凭据。绝不要读取、解密、打印、复制或修改 `credentials.yaml`，也不要在文件或日志中搜索 secret。请严格使用下述流程。

## 工作流程：绑定或注册邮箱账号

### 第 1 步, 读取公开邮箱状态

从 `agent.json` 读取 `mail.is_new_account`、`mail.credential.name` 和 `mail.credential.domain`。当前支持的个人邮箱域名对应的 `provider` 应为空字符串。

如果不存在 `mail`，请用户先在 QwenPaw 的智能体设置界面配置“邮箱管理”。

### 第 2a 步, `is_new_account` 为 `false`：管理已有邮箱

1. 直接调用 `check_auth`。托管 DriverCard 已经通过运行时凭据引用获取加密存储中的邮箱凭据；不要从 `agent.json` 查找凭据，也不要因为看不到 secret 字段就调用 `set_credentials`。
2. `check_auth` 成功后，执行用户要求的邮件操作。
3. 如果凭据缺失或失效，请用户在 QwenPaw 中编辑当前智能体，选择“管理你的个人邮箱”，重新填写邮箱凭据并保存。智能体重载后再次调用 `check_auth`。
4. 如果用户在当前对话中明确提供邮箱地址和凭据，可以调用 `set_credentials` 作为仅限当前会话的临时覆盖，随后调用 `check_auth`。它不会更新 QwenPaw 的加密配置，MCP 进程重启后即失效。

The rest: https://github.com/agentscope-ai/QwenPaw/blob/HEAD/src/qwenpaw/agents/skills/mailbox-zh/SKILL.md