用途:mailbox 是处理邮箱/邮件操作的统一入口,任何检查、读取、搜索、发送、回复、转发、整理、删除邮件等需求都应通过它调用 qwenpawmail-mcp 完成,不要自行绕开改用原始 IMAP/SMTP 命令。
支持范围:托管流程支持九个域名——网易(163.com、126.com、yeah.net)、腾讯(qq.com、foxmail.com)、新浪(sina.com、sina.cn)、阿里云(aliyun.com)、Google(gmail.com)。网易/腾讯/新浪/Gmail 使用 16 位授权码或应用专用密码,阿里云使用邮箱登录密码且仅限已有账号。企业邮箱、自定义域名和微软邮箱不在当前托管流程支持范围内。
使用方式:先读取 agent.json 中的公开邮箱状态(is_new_account、credential.name、credential.domain)。已有邮箱直接调用 check_auth,成功后执行所需操作;凭据缺失或失效时,请用户在 QwenPaw 设置界面重新配置。新建邮箱时按域名调用 create_mailbox 获取注册指引,密码、手机号、验证码由用户在可见浏览器或官方页面自行完成,注册成功后再由用户填入最终授权码。临时会话覆盖可用 set_credentials,仅当前进程有效。
主要工具:只读类有 list_folders、list_messages、get_message、get_attachment、search_messages、check_auth、create_mailbox、list_threads、search_threads、get_thread、get_mailbox_stats;写入类有 send_message、reply_message、forward_message、mark_messages、move_message、create_folder、set_credentials、clear_credentials、update_thread;删除类有 delete_message、delete_thread。
限制与安全:授权码、密码、手机号等敏感字段不会写入 agent.json,需加密存储且不得读取、打印或修改 credentials.yaml。删除操作前应先与用户确认;消息 UID 以文件夹为范围且可能变化,操作前需重新获取。凭据变更后应先调用 check_auth。具体收费、价格及更多平台细节暂未提供。