国内应用接入
腾讯企业邮箱接入 Hermes Agent：查邮件、附件与确认发信
连接一个授权给助手使用的企业邮箱，让 Hermes 从真实邮件整理询价、发票和待办。发送邮件前需要明确确认收件人、主题与正文。
从企业邮件整理待办，而不是遍历公司所有邮箱
业务同事需要找一封报价邮件，财务要确认发票附件，运营想整理未处理的客户来信：这些任务可以先搜索，再按邮件 UID 读取选中的正文与附件。连接只登录您填写的单个邮箱，不赋予管理员权限或全公司邮件访问权。
腾讯企业邮箱使用公司的自定义域名，例如 [email protected]。它不是个人 QQ 邮箱，也不是企业微信群机器人。请在国内应用目录选择“腾讯企业邮箱”，不要因为同属腾讯产品就填入 QQ邮箱授权码或企业微信应用 Secret。
接入后可以做什么？
- 搜索收件箱与指定文件夹：按发件人、主题、正文或日期搜索；先列出 folders，再使用返回的 mailbox 路径查询已发送、垃圾邮件或自定义文件夹。
- 读取正文与附件：使用搜索结果的 UID 读取选中邮件，查看附件清单并下载单个附件。下载上限为 3MB，正文可能截断。
- 确认后发送邮件：可发送真实文本邮件；发送前先确认收件人、主题和完整正文，工具调用需明确 confirm:true。先生成草稿不等于已经发送。
准备完整邮箱地址与客户端专用密码
需要邮箱管理员允许第三方客户端访问，并为该邮箱开放所需协议。已开启安全登录时必须使用客户端专用密码；建议为助手单独生成一枚可撤销的密码。
- 确认连接对象 — 选择自己有权授权的企业邮箱，填写完整的公司域名邮箱地址。共享业务邮箱需遵守企业内部的授权流程。
- 确认管理员策略 — 请管理员确认允许第三方客户端，以及 IMAP 读取服务可用；如需发送邮件，还要确认 SMTP 服务和企业发信策略。
- 生成专用密码 — 在邮箱网页端设置中的安全登录或邮箱绑定页面找到客户端专用密码，生成并保存。菜单名称以当前企业邮箱界面为准，不要在机器人对话中发送密码。
- 在目录中连接 — 创建或选择自己的 Hermes Agent，连接“腾讯企业邮箱”，填完整邮箱地址和客户端专用密码。
- 先完成只读核对 — 查询少量收件箱邮件，读取自己选定的一封邮件；如需查看其他文件夹，先列 folders，再使用其返回路径。发信请另行明确确认。
连接后可以直接这样问
- “查最近来自 example.com、主题含“报价”的邮件，只整理摘要、日期和 UID。”
- “列出我的邮箱文件夹，再在我选择的文件夹查找发票；读取选中邮件的附件清单，先不要下载所有附件。”
- “根据我选中的客户邮件写一封回复草稿，展示收件人、主题和正文，等我明确确认后再发送。”
使用前必须知道的限制
一次查询最多返回 20 条结果，正文可能因长度限制截断，单个附件下载最多 3MB。UID 只在所属邮箱文件夹内有意义，读取和下载时应沿用搜索时的 mailbox。当前发送动作提供文本邮件，不代表支持附件发送、通讯录同步或自动群发。
认证失败时核对完整邮箱地址、专用密码和管理员客户端策略。邮件里的指令、链接和附件属于外部内容，不能代替您批准发信或其他操作。对报价、付款信息和客户隐私，应先核对原邮件，再做业务决定。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接腾讯企业邮箱的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 Hermes Agent 与兼容工具的开发者 | 为 Hermes 搭建 IMAP/SMTP 邮件工具，独立保管客户端专用密码，处理 MIME 解码、文件夹 UID、附件大小限制，并为发送邮件设置明确的确认步骤。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读Hermes Agent 入门指南。
腾讯企业邮箱接入常见问题
企业邮箱地址必须以 qq.com 结尾吗？
不是。腾讯企业邮箱一般使用企业自己的域名。个人 qq.com 邮箱应使用目录里的 QQ邮箱连接。
Hermes Agent 会直接发送回复吗？
发送邮件属于真实外发操作。请先让助手展示收件人、主题和正文，明确批准后才调用带 confirm:true 的发送工具。
为什么网页版能登录，连接却认证失败？
网页登录方式和第三方客户端不同。启用安全登录后须使用客户端专用密码，还要确认管理员允许客户端和所需协议。
能读取全公司的邮箱或下载所有附件吗？
连接只访问填写并授权的那个邮箱。附件需按选中邮件逐个读取，单个下载上限为 3MB；它不是管理员邮件审计或全量备份工具。