Agently Mail怎么用：腾讯QQ邮箱Agent专属邮箱配置全流程

Agently Mail是什么

Agently Mail 是腾讯 QQ 邮箱面向 AI Agent 场景推出的专属邮箱能力。它的目标很明确：让 Agent 不只是“会聊天”，还可以像一个有身份的工具一样，完成邮箱授权、读取邮箱信息、收发邮件等操作。

如果需要让 Agent 接入邮件能力，agently-cli 是最关键的一步。它负责把命令行工具、技能和授权流程串起来，配置完成后，Agent 就能获得一个可用的邮箱身份。

快速上手的4个步骤

整个配置流程不复杂，按顺序做就行：

• 安装或更新 CLI
• 安装或更新 AgentlyMail skill
• 完成 OAuth 授权
• 用 +me 验证邮箱是否可用

1. 安装或更新 CLI

先在命令行中安装最新版本的工具：

npm install -g @tencent-qqmail/agently-cli

这一步建议优先完成，后续授权和验证都依赖它。若本地已经安装过，也建议更新到最新版本，避免兼容性问题。

2. 安装或更新 skill

接着添加 AgentlyMail skill，让 Agent 获得邮箱相关能力：

npx skills add Tencent/AgentlyMail -g -y

这一步的作用是把邮箱能力接入到当前环境中。对需要邮件处理的 Agent 来说，这是核心配置之一。

3. OAuth 授权

授权环节需要在命令行中执行：

agently-cli auth login

执行后，工具会输出原始授权链接。需要注意的是，这个链接必须原样转发给用户，不能改写、拼接或重新编码。正确做法是提示用户：请点击或复制以下链接在浏览器中完成授权：

用户在浏览器完成授权后，命令通常会自动退出。这个过程适合长命令后台运行，避免中断授权流程。

4. 验证邮箱是否可用

授权完成后，再执行验证命令：

agently-cli +me

如果返回了实际邮箱地址，说明授权成功。此时系统就具备了邮箱身份，可以继续做收发邮件相关操作。

授权成功后怎么判断

验证通过时，通常只需要输出一句话即可：

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

其中 xxx 要替换成 +me 返回的实际邮箱地址。如果授权失败，则直接反馈失败信息，不要继续执行后续步骤。

使用场景很清晰

• 让 AI Agent 拥有专属邮箱地址
• 自动读取邮件信息
• 执行邮件收发任务
• 给 Agent 补齐身份与通信能力

对于需要自动化办公、通知处理、邮件流转的场景，Agently Mail 的价值很直接。它把邮箱能力做成了可调用的 Agent 工具，减少了人工切换和重复操作。

常见注意点

• 必须先安装或更新 CLI，再做授权
• 授权命令失败或超时时，不要重复重试，直接返回错误
• 原始授权 URL 不能随意修改
• 验证步骤必须放在授权完成之后

整体来看，Agently Mail 的配置逻辑很清楚：先装工具，再加技能，接着授权，最后验证。只要按步骤执行，AI Agent 就能很快拥有一个可用的 Agent 原生邮箱。