Email 配置教程
本文以 QQ邮箱 说明如何配置 Email 适配器，并将 Nekro Agent 接入邮箱收发流程。
提示
当前版本适配器暂不支持需要OAuth认证的邮箱，如Gmail，Outlook等
提示
不同邮箱的设置不同，请以实际邮箱为准
开始前准备
- 你已经部署好 Nekro Agent
- 你有一个准备用来测试的邮箱
- 这个邮箱已经在邮箱后台打开了
IMAP和SMTP - 你已经拿到邮箱的授权码或应用专用密码
第一步：进入邮箱后台，获取认证码
- 登录 QQ邮箱
- 点击右上角账户名下的
账号与安全 - 在弹出的页面内点击
安全设置后点击POP3/IMAP/SMTP/Exchange/CardDAV 服务下的开启服务 - 根据指引开启相关服务
- 记录授权码
第二步：在 Nekro Agent 里添加邮箱账户
- 打开「适配器」->「Email」
- 打开
启用适配器 - 在
邮箱账户列表新增一个邮箱账户 - 填写
邮箱提供商 - 填写
邮箱地址和授权码 - 如果这个账户还要发信，就打开
启用发信 - 如果你只想固定用这个号发信，再打开
默认发件人 - 保存配置并重启Nekro Agent
常用字段怎么填
邮箱提供商：常见可以直接填入QQ邮箱、163邮箱、自定义邮箱用户名：完整邮箱地址，例如[email protected]邮箱密码/授权码：授权码或应用专用密码启用发信：要不要允许这个邮箱发信默认发件人：是不是默认发件人
如果你选择的是 自定义，还要额外填写：
自定义 IMAP 主机自定义 IMAP 端口自定义 SMTP 主机自定义 SMTP 端口自定义 SMTP SSL 端口
第三步：设置轮询和通知
你至少要看这几个全局配置：
轮询间隔(秒)：多久检查一次新邮件，默认 30 秒仅拉取未读：是否只抓未读邮件每次最大抓取数：每次最多抓多少封读取后标记已读：读取后是否标记已读启用新邮件通知：是否启用新邮件通知新邮件通知聊天频道：通知要发到哪个聊天
第一次使用时，建议先保持默认值，只在确实需要时再调。
第四步：确认是否配置成功
- 给这个邮箱发一封测试邮件
- 等待一个轮询周期
- 看 Nekro Agent 中是否出现新的 Email 聊天
- 如果你打开了发信功能，再尝试让 AI 发送一封测试邮件
你配置完成后会看到什么
每个邮箱账户都会变成一个单独聊天：
text
email-你的邮箱地址例如：
附件会存到哪里
邮件附件会自动保存到：
text
data/uploads/email_attachment/{邮箱账户}/{邮件UID}/{附件文件名}如果你计划让 AI 处理附件，记得保证数据目录可写。
常见问题
明明账号密码没错，但连不上
大多数时候不是密码错，而是你填了登录密码而不是授权码。
能收邮件，但不能发邮件
优先检查：
- 当前账户是否打开了
启用发信 - SMTP 是否已经在邮箱后台启用
- 这个邮箱是否被设成默认发件人，或者你发送时有没有明确指定账户
两个邮箱都被设成了默认发件人
不行。默认发件人只能有一个。