前言¶
让 Agent 代你读信、搜信、发信时，常见做法是接 IMAP/SMTP 或自建网关：凭证要交给模型侧工具链，和个人 QQ 邮箱混用也容易误操作。Agently Mail 由 QQ 邮箱团队发布，在 SkillHub 上以 @tencent-adm/agently-mail 提供，面向 Agent 的专属邮箱与个人邮箱隔离，并声明 requires_api_key=false，不依赖额外 API Key 配置。
下面介绍它是什么、能做什么，以及如何通过 SkillHub 安装到当前 Agent 环境。
这是什么¶
Agently Mail 是 QQ 邮箱团队为 Agent 打造的专属邮箱服务。与个人邮箱隔离，按官方说明原生适配 Agent，用于在 Agent 工作流里安全、高效地收发邮件。
- 维护方：QQ 邮箱（SkillHub 发布者标注为「QQ邮箱」）
- Skill 坐标：
@tencent-adm/agently-mail（SkillHub 当前版本 1.0.13，分类 ai-agent，来源 enterprise） - 产品官网：https://agent.qq.com
- Skill 入口：https://www.skillhub.cn/skills/tencent-adm/agently-mail
核心功能¶
以下能力均来自 SkillHub 与官方 Skill 简介，未在资料中出现的接口或参数不作延伸。
- 授权：支持微信登录授权。
- 读与搜：读取邮件、搜索邮件。
- 写与流转：发送邮件、回复、转发；可将邮件移动到已删除。
- 附件：上传与下载附件。
Skill 采用通用 SKILL.md 格式，具体工具名与调用方式以安装包内说明为准。
安装与启用¶
官方页面给出的安装指引是：让 Agent 参照 SkillHub 安装文档，安装 @tencent-adm/agently-mail。对应人类可执行的流程如下。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 Agently Mail 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法识别。
skillhub install @tencent-adm/agently-mail --dir <skills 目录>
常用客户端的 skills 路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
不同 Agent 的目录名可能随版本变化，以你本机配置为准。安装后按所用客户端要求重启或重新加载 Skills。
资料中未单独列出 Cursor、Codex CLI、Claude Code 的差异步骤；三者差异主要体现在 --dir 目标路径，安装命令本身相同。
典型用法¶
公开页面未提供独立的脚本级「端到端示例」。可复现的用法路径是：
- 按上一节完成
skillhub install @tencent-adm/agently-mail --dir <skills 目录>。 - 在 Agent 对话中说明邮件相关任务（例如检索某主题邮件、代发回复、处理附件）；Agent 读取 Skill 内 SKILL.md 后调用对应能力。
- 首次使用按 Skill 指引完成微信登录授权（官方简介中列出的授权方式）。
不要在未阅读 SKILL.md 的情况下假设具体的 HTTP 路径或 JSON 字段。
适用场景与注意¶
适合：需要在 Agent 里自动化邮件读写、检索、回复与附件处理，且希望与个人 QQ 邮箱账号隔离的开发者或团队。
注意：
- 账号与数据边界以官网 https://agent.qq.com 及 Skill 内说明为准；个人邮箱与 Agently 专属邮箱不要混用同一套操作假设。
- 标签标明
requires_api_key=false，不代表无需登录；微信授权仍是资料中明确列出的环节。 - 企业来源（enterprise）Skill，升级与合规要求以 SkillHub 与发布方为准，安装前可用
skillhub search/ 商店页核对版本（当前 1.0.13）。
结尾¶
Agently Mail 把 QQ 邮箱团队的 Agent 专属邮件能力封装成 SkillHub 上的 @tencent-adm/agently-mail：隔离个人邮箱、覆盖读搜发回转发删与附件，并支持微信授权。安装时记住 skillhub install 的 --dir 与 Cursor / Claude Code / Codex 各自的 skills 路径。
- SkillHub：https://www.skillhub.cn/skills/tencent-adm/agently-mail
- 官方 Skill 地址：https://api.skillhub.cn/tencent-adm/agently-mail
- 产品官网：https://agent.qq.com
