解决日常邮件管理效率低的问题，Agent方式操作QQ邮箱，支持读取、发送、回复、搜索邮件及附件下载。适用于需要批量处理邮件、自动归档、或在Agent工作流中集成邮件功能的用户。安装后通过OAuth微信授权即可使用，无需配置API Key。

【适用场景】

1. 日常邮件管理：需要定期查阅、分类、归档邮件的用户； 2. 邮件自动化流程：在Agent工作流中集成邮件收发，如自动发送报告、自动回复客户邮件； 3. 邮件内容提取：批量提取邮件中的附件或关键信息； 4. 多邮箱协作：需要在一个界面内操作多个邮箱的场景。

【操作步骤】

第一步：安装CLI和Skill 在终端执行以下命令安装Agently Mail CLI工具和Skill： npm install -g @tencent-qqmail/agently-cli npx skills add Tencent/AgentlyMail -g -y

第二步：OAuth授权 执行登录命令： agently-cli auth login 命令会输出一个授权URL，将该URL以代码块形式发送给用户，让用户在浏览器中完成授权。 授权完成后命令自动退出。

第三步：验证授权状态 执行以下命令验证是否授权成功： agently-cli +me 成功输出：邮箱地址 xxx 已授权成功，可以用它来收发邮件了

第四步：常用邮件操作 列出邮件： agently-cli message +list 读取邮件： agently-cli message +read --id msg_xxx 搜索邮件： agently-cli message +search --q "关键词" 发送邮件： agently-cli message +send 回复邮件： agently-cli message +reply --id msg_xxx 转发邮件： agently-cli message +forward --id msg_xxx 下载附件： agently-cli attachment +download --msg msg_xxx --att att_xxx

【代码模板】

授权验证

agently-cli +me

输出：邮箱地址 xxx 已授权成功，可以用它来收发邮件了

列出收件箱前10封

agently-cli message +list

搜索含"合同"的邮件

agently-cli message +search --q "合同"

读取指定邮件

agently-cli message +read --id msg_abc123

发送附件邮件（两阶段确认）

agently-cli message +send --to user@example.com --subject "报告" --body "请查收附件" --attachment /path/to/file.pdf

【复盘要点】

1. OAuth授权只需一次：授权完成后凭据保存在本地，后续操作无需再次授权； 2. 两阶段确认机制：发送重要邮件时系统会要求用户确认，请仔细核对收件人和邮件内容； 3. 附件下载注意大小：普通附件直接下载，超大附件会返回下载链接，需用户手动下载； 4. ID格式：邮件ID格式为msg_开头，附件ID格式为att_开头，不可混用； 5. 授权失败处理：若auth login失败或超时，直接将错误信息反馈给用户。

来源：SkillHub https://skillhub.cn/skills/agently-mail