mailbox

邮箱操作 (qwenpawmail-mcp)

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

支持的邮箱服务商

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

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

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

调用规则

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

凭据与配置模型

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

{
  "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 进程重启后即失效。

临时调用 set_credentials 时，传入完整邮箱地址，并把服务商所需凭据放入名为 auth_code 的参数。对于 aliyun.com，该参数实际填写登录密码；其他受支持域名填写 16 位授权码或应用专用密码。