邮件集成

wesclaw 支持将邮箱账号接入 AI 助手，实现自动收信处理、智能邮件管理和邮件发送等功能。

概述

邮件集成是 wesclaw 的外设能力之一，通过 IMAP 协议收取邮件、SMTP 协议发送邮件。AI 可以根据收到的邮件内容自动触发对话，帮助你处理日常邮件事务。

核心能力：

• 自动收取并解析邮件内容
• AI 根据邮件内容智能回复或执行任务
• 支持多邮箱账号管理
• 邮件发送能力（AI 可代为撰写并发送邮件）

配置邮箱账号

添加邮箱

1. 打开 设置 → 邮件
2. 点击 添加邮箱账号
3. 填写以下信息：

4. 点击 测试连接 验证配置
5. 保存

常见邮箱配置

QQ 邮箱

Gmail

重要：不要直接使用邮箱登录密码。大多数邮箱服务商要求使用"授权码"或"应用专用密码"。

企业邮箱（腾讯/网易）

请参考对应企业邮箱管理后台的 IMAP/SMTP 设置页面获取配置信息。

AI 自动收信处理

工作原理

1. wesclaw 定期通过 IMAP 协议拉取新邮件
2. 新邮件到达后自动解析邮件内容（主题、正文、附件信息）
3. AI Agent 收到邮件内容作为输入，生成回复或执行相应操作
4. 回复可以自动通过 SMTP 发回给发件人

启用自动收信

在邮箱账号配置完成后：

1. 确保邮箱账号状态为"已连接"
2. 在 Agent 配置中启用邮件渠道
3. 设置轮询间隔（默认每分钟检查一次）

邮件防环机制

wesclaw 内置了邮件循环检测机制，防止 AI 回复邮件后又触发自动处理形成死循环：

• 检测 Auto-Submitted 邮件头
• 检测邮件的 References / In-Reply-To 链
• 对同一发件人的连续自动回复设有频率限制

邮件发送

AI 可以通过邮件工具代你发送邮件。在对话中，你可以这样使用：

请帮我给 bob@example.com 发一封邮件，主题是"会议安排"，
内容是明天下午 3 点在会议室 A 开项目进度会议。

AI 会：

1. 解析收件人、主题、正文
2. 使用你配置的邮箱账号通过 SMTP 发送
3. 发送前会征求你的确认（可在设置中配置是否跳过确认）

发送确认

默认情况下，AI 在发送邮件前会显示邮件预览并请求确认：

📧 邮件预览：
收件人：bob@example.com
主题：会议安排
正文：明天下午 3 点在会议室 A 开项目进度会议。

确认发送？[发送] [取消]

多邮箱管理

wesclaw 支持配置多个邮箱账号。

管理入口

• 设置 → 邮件 页面可以查看所有已配置的邮箱账号
• 每个账号显示连接状态（已连接/断开/配置错误）
• 支持对单个账号进行编辑、测试连接和删除操作

邮箱配额

邮箱账号数量受 Cell 配额限制（MaxEmailAccounts）。超过配额后将无法添加新邮箱，需要先删除不需要的账号。

使用场景

注意事项

安全

• 邮箱密码/授权码经 AES-256-GCM 加密存储在本地
• 密码不会以明文形式出现在日志或配置文件中
• 建议使用"应用专用密码"或"授权码"，避免使用邮箱主密码

限制

• 附件仅解析元信息（文件名、大小、类型），不自动下载大附件
• 邮件正文过长时会被截断后传递给 AI
• HTML 邮件会被转换为纯文本后处理
• 邮件轮询间隔最小 1 分钟

SaaS 版差异

SaaS 云端版本的邮件集成：

• 邮箱凭证存储在服务端（加密）
• IMAP/SMTP 连接由服务端发起
• 不支持需要本地网络访问的邮箱服务器（如公司内网邮箱）

故障排查

连接失败

1. 检查邮箱服务商是否开启了 IMAP/SMTP 服务
2. 检查是否使用了正确的授权码
3. 检查端口号和加密方式（SSL/TLS）是否正确
4. 部分邮箱服务商需要在网页端开启"第三方客户端登录"

收不到邮件

1. 确认邮箱账号连接状态为"已连接"
2. 检查 IMAP 配置是否正确
3. 查看 wesclaw 日志中是否有 IMAP 相关错误
4. 确认轮询任务是否正常运行

发送失败

1. 点击"测试连接"验证 SMTP 配置
2. 检查 SMTP 授权码是否过期
3. 部分邮箱对发送频率有限制，短时间内大量发送可能被拦截

下一步

• IM 渠道接入 — 连接企业微信、飞书等 IM 平台
• 定时任务 — 设置定时邮件处理任务
• Agent 配置 — 为不同邮箱配置不同的 AI Agent