夜雨聆风AI助手能写代码、能查资料、能做PPT，但有件事一直挺尴尬——它没有自己的邮箱。
收个验证码得借你的，发封邮件得你手动转发，想让两个Agent互相协作？没门。
腾讯最近出了个东西叫 Agent Mail，专门解决这个问题。我昨晚亲手跑了一遍全流程，从安装到发出第一封邮件，踩了不少坑，也填了不少坑。今天把真实过程写出来，你能少走弯路。
Agent Mail 到底是个啥
一句话：给每个 Agent 分配一个 @agent.qq.com 的专属邮箱。
有了这个邮箱，Agent 能自己收验证码、接通知、发邮件、处理附件。更关键的是，不同 Agent 之间可以通过邮件互相派活、同步结果、协同工作。以前谈 Agent 协作默认要搞 API、消息队列、MCP 协议，腾讯这次直接用邮件这个老古董当通道。
目前还在内测，但已经能用了。
开通：创建你的 Agent 邮箱
打开 agent.qq.com，微信扫码登录。
页面会提示你创建邮箱地址。规则很简单：字母开头，6到18位，只能包含字母和数字。系统会默认给你生成一个前缀，你可以改。
我创建的是 subianlihuangchao@agent.qq.com。
创建完之后，邮箱就存在了，但还没和任何 Agent 绑定。状态显示"未接入 Agent"。
安装 CLI 工具
在终端执行：
npm install -g @tencent-qqmail/agently-cli装完你会得到一个全局命令 agently-cli，后面所有操作都靠它。
有个小坑：如果你用 Git Bash，可能会提示 npm: command not found。切到 PowerShell 或 CMD 就行。
安装 Skill
CLI 装好后，再执行：
npx skills add https://agent.qq.com --skill -g -y这一步会把 Agent Mail 的技能包安装到你的 Agent 配置目录。有意思的是，它会自动扫描你机器上装了哪些 Agent 客户端——我这边检测到了 CodeBuddy、Claude Code、Cursor、Codex 等 14 个，然后逐一适配。
安装完，你的 Agent 就具备了收发邮件的能力。
OAuth 授权：踩坑最多的环节
执行：
agently-cli auth login命令会吐出一个授权链接，你复制到浏览器打开，微信扫码确认。
听起来很简单对吧？实际操作我踩了三个坑。
第一个坑：链接会过期。
OAuth 授权链接有有效期，大概几分钟。如果你扫码慢了，或者中间分了心，链接就失效了。CLI 会报 authorization expired, please retry，你得重新执行 auth login 拿新链接。
我前后扫了四五次码才成功。建议你拿到链接后立刻扫，别犹豫。
第二个坑：凭证写入被拦截。
扫码成功后，CLI 需要把 OAuth token 写到 ~/.agently-cli/.config.json。但如果你在沙箱环境里跑，这个写操作会被拦下来。
报错信息是：failed to store credentials: atomic write: create temp: open ... .config.json.xxx.tmp: The system cannot find the file specified.
表面上说"找不到文件"，实际上是写权限被拒了。你在网页端能看到"接入成功"，但本地 CLI 这边 token 没存下来，+me 一查还是"authorization required"。
解决办法：确保 CLI 运行时对 ~/.agently-cli/ 目录有写权限。如果你用了沙箱或权限隔离工具，需要把写权限放开。
第三个坑：网页端和 CLI 状态不同步。
你在浏览器里扫码后，网页会显示"Agent Mail 接入成功"，邮箱地址也显示出来了。但这不代表 CLI 这边也成功了。两边是独立的——网页端记录的是"你的微信绑定了这个邮箱"，CLI 端需要的是"OAuth token 写进了本地配置文件"。
一定要用 agently-cli +me 验证 CLI 这边是否真的通了。
验证：确认绑定成功
授权成功后，执行：
agently-cli +me如果看到类似下面的输出，说明接入成功：
{
"ok": true,
"data": {
"aliases": [
{
"email": "subianlihuangchao@agent.qq.com",
"is_primary": true
}
],
"scopes": ["alias:read", "mail:delete", "mail:read", "mail:send"],
"rate_limits": {
"daily_send_quota": 50,
"requests_per_hour": 200,
"requests_per_minute": 10
}
}
}关键信息：邮箱地址、权限范围（读/发/删邮件）、速率限制（每天50封，每小时200次请求，每分钟10次）。
实测：发一封天气预报邮件
绑定成功后，我试着发了一封郑州未来一周的天气预报邮件。
Agent Mail 发邮件用两阶段确认机制。第一次执行 message +send，CLI 不会直接发，而是返回一个确认 token 和邮件摘要，让你核对收件人、主题、发件人没问题后，再带上 token 执行一次，邮件才会真正发出。
# 第一次调用，拿到 token
agently-cli message +send --to xxx@example.com --subject "主题" --body-file body.txt
# 第二次调用，带上 token 确认发送
agently-cli message +send --to xxx@example.com --subject "主题" --body-file body.txt --confirmation-token ctk_xxxxx这个设计是为了防误操作。毕竟 Agent 自动发邮件，万一参数拼错了，发了就撤不回来。加一道确认，多一层保险。
邮件正文建议用 --body-file 传文件，别用 --body 直接传字符串。多行文本在命令行里转义容易出问题，文件方式更稳妥。
发送结果：两个邮箱，两种结局
我把同一封天气预报邮件发了两个地址：
- QQ 邮箱（subianlihuangchao@qq.com）：秒到，收件箱里清清楚楚。
- 扣子邮箱（subianlihuangchao@coze.email）：发件箱有记录，但对方收件箱没收到。
Agent Mail 这边 queued: true 返回了，发件箱也能看到记录，但扣子邮箱那边就是没收到。大概率是 coze.email 对 agent.qq.com 的投递做了限制，或者被归到垃圾邮件了。
所以如果你要测试，建议先用 QQ 邮箱或主流邮箱验证，第三方小众邮箱的投递不一定靠谱。
几个值得注意的限制
发送额度：每天最多 50 封，每小时 200 次请求，每分钟 10 次。日常使用够了，批量场景得控制节奏。
附件：单封邮件最多 50 个附件，总大小 20MB。大文件得另想办法。
数据隔离：Agent Mail 和你的个人 QQ 邮箱完全隔离，互不影响。你在 agent.qq.com 管理页可以查看发信昵称、接入工具、连接状态，也支持解绑和注销。
写在最后
Agent Mail 现在还只是个邮箱服务，但它的定位很明确：给 Agent 一个独立于人类的通信身份。
往近了说，你的 AI 助手能自己收发邮件了，不用你再当中转站。往远了看，如果腾讯把微信、企业微信、公众号的消息能力都接进来，这个 @agent.qq.com 地址可能变成 Agent 在整个腾讯生态里的数字身份证。
现在内测阶段，门槛低，限制也还在。建议先注册个地址，把 CLI 跑通，发封测试邮件试试水。等正式版上线那天，你已经是有经验的老手了。
操作不复杂，就是坑有点多。希望这篇实录能帮你少踩几个。