Agent Mail 是 QQ 邮箱团队为 Agent 打造的专属邮箱服务。它与个人邮箱隔离，原生适配 Agent，助力你安全、高效地用 Agent 收发邮件。整个接入只需发送一句话、用微信扫码授权即可完成。

 

支持的 Agent

Agent Mail 已支持 WorkBuddy、QClaw、Marvis、OpenClaw、Claude Code、Kimi Work、豆包超能模式、Codex、Hermes、Cursor 等 Agent 

 

接入步骤

在 WorkBuddy 中启用 Agent Mail

WorkBuddy 最新版本（个人版）已支持无需安装直接启用 Agent Mail，请下载或更新最新版 WorkBuddy （ 个人版 v5.3.5及以上）更新以后，请在 WorkBuddy 首页点击 更多-我的邮箱 即可启用 Agent Mail.

WorkBuddy 下载：https://www.codebuddy.cn/work

如果之前在 WorkBuddy 已经手动安装过 Agent Mail ，在新版 WorkBuddy 启用 Agent Mail 会提示重复和冲突，建议继续开通 Agent Mail 服务。启用后，如果原先在 WorkBuddy 创建了 Agent Mail 相关的自动化任务，你需要修改一下自动化任务，你可以让  WorkBuddy 帮你修改成使用 我的邮箱里的绑定 Agent Mail .

企业版 WorkBuddy （使用企业账号登录） 暂时还不支持 更多-我的邮箱 入口，可以参考下方的安装方式。

在其他 Agent 安装 Agent Mail

QClaw、Marvis、OpenClaw 等国内外 Agent 可以使用此接入方式，接入过程由 Agent 自动完成，无需手动安装任何工具。

开始使用

接入后无需记忆任何命令，直接用自然语言向 Agent 描述需求即可。

发邮件	帮我给 zhangsan@example.com 发一封邮件，内容是……
查看收件	看看我最近收到了哪些邮件
检索邮件	找一下上周关于项目进度的那封邮件
删除邮件	删除主题为 xxx 的邮件
回复邮件	回复刚才那封邮件，告诉对方我已收到
发送附件	发邮件给 xxx，并把这份文件作为附件
下载附件	把主题为 xxx 邮件的附件下载到本地

除了上述通过自然语言在 Agent 中使用 Agent Mail ，你还可以在 Agent 中使用 Agent Mail 创造你自己的工作流。比如：

1.使用 Agent Mail 邮箱地址订阅行业新闻资讯，让 Agent 每天定时帮你整理收到行业新闻资讯邮件。

2.你也可以让 Agent 每天定时网络检索和整理行业新闻资讯，使用 Agent Mail 发送至 XXXX 邮箱。

3.自动处理发票，你可以告诉 Agent ，设置轮询任务，当 Agent Mail 收到发票邮件以后，自动将发票文件信息提取到 Excel 文件中，并发送至 XXXX 邮箱。（需要注意有些发票文件是在邮件正文 URL 中）

4.你可以将个人邮箱（比如 QQ 邮箱、网易邮箱、Outlook、Gmail）中需要处理的邮件设置自动转发到 Agent Mail ，并告诉 Agent 轮询邮件，收到邮件后如何处理（比如提取附件，自动将附件下载并重命名等）

除了上述案例以外，你可以自由地使用 Agent Mail 创造各种各样的工作流，提升你的生活和工作效率。

常见问题

会用到我的私人 QQ 邮箱吗？

不会。Agent 使用独立创建的专属地址，与个人邮箱完全隔离，互不影响。

 

发送指令的窗口在哪？

发送的窗口在 Agent 中，你可以下载安装下列任何一款 Agent 软件。下载安装完成登录以后在软件窗口发送你在 Agent Mail 官网复制的提示词，Agent 即可帮你自动完成 Agent Mail 接入。在接入过程中你可能需要登录你的 Agent Mail 账号，请按照 Agent 中提示进行操作即可。

QClaw  下载：https://qclaw.qq.com

WorkBuddy 下载：https://www.codebuddy.cn/work

Marvis 下载：https://marvis.qq.com

 

扫码显示登录失败？

1.将 Agent 给出的链接原样复制到浏览器打开，不要修改链接内容。

2.可能是登录链接已过期，请让 Agent 重新生成，你可以这样和 Agent 说 “请帮我生成新的 Agent Mail 的授权链接”

 

在哪里管理我的 Agent 邮箱？

在电脑可以访问管理页面 agent.qq.com 进行查看收发的邮件和管理地址。

在手机上可以使用对应注册 Agent Mail 的微信扫下方二维码访问 Agent Mail 小程序。

 

怎么修改邮箱地址？

你可以通过访问 Agent Mail 页面 agent.qq.com 点击 管理邮箱地址 即可对地址进行修改。每个邮箱地址仅能修改一次，修改后旧地址将失效。

 

随机地址没修改过，注销了，再注册是否可以修改？

如果随机地址没修改过，注销以后，再注册还是可以修改的。

具体的修改流程为：请先注册地址，注册过程中可能提示恢复使用90天内注册的地址，如你未修改过随机生成的地址，请忽略这个提示，继续注册。

地址注册成功后，请在 管理邮箱地址 页面对注册的地址进行修改。需要注意：每个地址仅能修改一次。

 

Agent Mail 发送的邮件进了垃圾箱？

Agent Mail 发送的邮件一般不会进入垃圾箱，除非邮件内容可能有触发垃圾箱逻辑。如你发送给个人的邮件进入垃圾箱，请手动将此邮件移出垃圾箱或者手动标记为不是垃圾邮件。

 

我电脑上安装了两个 Agent，怎么接不同地址的 Agent 邮箱？

目前新版本 Agent Mail CLI 已经支持在同一台电脑上不同 Agent 使用不同的地址，你可以更新 Agent Mail CLI 以后重新登录再使用，必须要重新登录一次。

需要注意：如果你是在 WorkBuddy 里面的“其他-我的邮箱” 里使用 Agent Mail ，则不需要在 WorkBuddy 里面安装或升级 Agent Mail CLI 

Agent Mail CLI 更新方法：请直接在 Agent 中发送 “请帮我升级 agently-cli 到最新版本” 或者粘贴指令： npm install -g @tencent-qqmail/agently-cli

Agent Mail CLI 重新登录方法：请直接在 Agent 中发送 “帮我重新登录 Agent Mail”  Agent 会生成登录链接给你。

 

我之前在 WorkBuddy 中手动安装了 Agent Mail ，新版本是否需要启用 “更多-我的邮箱”

建议启用，在 WorkBuddy 新版本中（个人版，版本号 v5.3.5及以上），Agent Mail 拥有了更好的体验，包括跨端同步、新消息通知与原生邮件列表等能力。

跨端同步：Agent Mail 跟随 Workbuddy 账号，无论在哪台设备上的 WorkBuddy 均可使用相同账号的 Agent Mail；

新消息通知：可以随时在 WorkBuddy 消息中心(左下角铃铛图标)查看新收到的邮件。

需要注意：如果之前在 WorkBuddy 创建了 Agent Mail 相关的自动化任务，你需要修改一下自动化任务，你可以让  WorkBuddy 帮你修改成使用 我的邮箱里的绑定 Agent Mail .

企业版 WorkBuddy （使用企业账号登录） 暂时还不支持 更多-我的邮箱 入口。

 

WorkBuddy 启用“我的邮箱”以后 Agent Mail 登录提示失败？

如果你在最新个人版 WorkBuddy 其他-我的邮箱 启用了 Agent Mail ，且之前手动通过 CLI 方式安装过 Agent Mail ，在使用 Agent Mail 过程中如果出现“登录失败，Workbuddy 已存在智能体邮箱，无需再绑定...” 等提示。

解决方法：

建议在 WorkBuddy 的“专家·技能·连接器”- 选择“技能” - 选择“我安装的” 找到 agently-mail ，将 agently-mail 技能关闭并卸载，卸载后 重启 WorkBuddy  再试。

 

WorkBuddy 中的邮箱地址怎么管理？

你可以更新新版 WorkBuddy （版本号 v5.3.5及以上） 在 v5.3.5 版本的 WorkBuddy 中的 更多-我的邮箱 中找到 管理邮箱 入口，点击管理邮箱即可跳转到邮箱地址管理页面。

 

在 Agent 中反复安装不上？

如安装几遍还是安装不上，请告诉 Agent 清除 Agent Mail 相关配置，然后在 Agent 中发送上述安装指令进行安装。

QClaw 记不住绑定的 Agent Mail 邮箱？

升级最新版本 QClaw ，然后在界面左侧栏上点击 连接 按钮，在连接界面上选择 个人邮箱 ，然后在弹出的菜单上选择 绑定 Agent 邮箱 使用微信扫码绑定你的 Agent Mail 即可。

Agent Mail 支持多大的附件多少个附件？

Agent Mail 目前支持附件最大为 20M，支持最多 50个附件。如果你的 Agent Mail 提示只支持 1M 附件，请直接在 Agent 窗口发送 升级 Agent Mail CLI 或 升级 Agently Mail CLI ，将 Agent 上的 Agent Mail 升级到最新版本。

Agent Mail 邮箱容量多大，额度限制？

Agent Mail 每个邮箱地址的邮箱容量是独立的，每个地址容量都为 1GB ，每个地址的每天发信额度为 50 封。可以登录 agent.qq.com 查看使用量。

QQ邮箱怎么设置自动转发？

你可以登录 QQ邮箱 网页版  mail.qq.com 在 「设置」-「收信规则」中新建收信规则，在收信规则中设置自动转发条件，将符合条件的邮件自动转发至 Agent Mail 

Agent Mail 邮件怎么删除？

接入 Agent 以后，你可以直接使用自然语言和 Agent 说你要删除 Agent Mail 中哪封或者哪些邮件，Agent 会帮你执行删除指令。需要注意，删除邮件是不可逆操作，请谨慎删除。

怎么升级更新 Agent Mail CLI 

请直接在 Agent 中发送 “请帮我升级 agently-cli 到最新版本” 或者直接在终端中粘贴指令并回车升级，指令为： npm install -g @tencent-qqmail/agently-cli

怎么实现新邮件推送自动化

Agent Mail CLI 在这 1.0.9 版本已经支持了通过 agently-cli message +watch 命令实现监听新邮件功能。具体请参考帮助文档 https://help.agent.qq.com/detail/0/1093

问题和需求反馈

请点击 https://agent.qq.com/page/feedback 反馈。