问题根源是协议配置错误、权限未授或技能缺失；需依次修正imap/smtp连接、安装邮件skills模块、配置复合分类规则、部署动态回复策略、启用附件文本提取与上下文联动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试让OpenClaw自动处理Gmail或Outlook邮箱中的新邮件，但分类结果混乱、回复未触发或连接频繁中断，则可能是由于协议配置错误、权限未正确授予或技能模块缺失所致。以下是解决此问题的步骤：
一、验证并修正IMAP/SMTP基础连接
确保OpenClaw能稳定收发邮件的前提是建立符合安全规范的加密通道。Gmail与Outlook均强制要求使用应用专用密码（而非账户密码）及TLS/SSL加密端口，任意一项配置偏差都将导致认证失败或连接超时。
1、打开OpenClaw主界面，进入「设置」→「邮件账户」→「新增账户」。
2、输入Gmail地址（如name@gmail.com）及对应的应用专用密码；若使用Outlook，需提前在account.microsoft.com中生成应用密码，并勾选「启用IMAP接收」和「启用SMTP发送」。
3、展开「高级设置」，分别填入：Gmail：IMAP服务器为imap.gmail.com:993，SMTP服务器为smtp.gmail.com:465；Outlook：IMAP与SMTP均为outlook.office365.com，端口分别为993与587。
4、点击「测试连接」，确认状态显示「已验证」后保存；若失败，检查是否已开启Gmail的“允许不够安全的应用”（不推荐）或是否启用两步验证后生成了应用密码。
二、安装并启用邮件专用Skills模块
OpenClaw主程序默认不具备邮件处理能力，必须通过ClawHub加载结构化技能包，才能解析邮件内容、执行移动归档、调用模板等动作。
1、在终端中运行：clawhub install email-agent imap-client email-classifier reply-generator。
2、确认各模块状态：执行clawhub list，输出中应包含上述四个已激活的技能名称及版本号。
3、重启网关服务以加载新技能：openclaw gateway restart。
4、检查日志是否出现Email classifier initialized with Qwen3.5-9B或类似提示，表明语义分析引擎已就绪。
三、配置多条件邮件分类规则
仅依赖发件人或主题关键词易造成误判，需结合元数据、正文语义置信度及附件特征构建复合判断逻辑，避免将含“报价”字样的垃圾邮件误标为重要。
1、进入「自动化」→「新建规则」，命名如“技术咨询邮件识别”。
OpenClaw 原生 PDF/文档处理技能，适用于 Nutrient DWS，帮助用户完成 PDF 转换、OCR、文字/表格提取、PII 脱敏等功能。
2、在「触发条件」中选择「收到新邮件时」，添加三项并列条件：发件人域名含@github.com或@gitlab.com；邮件正文长度＞200字符；且语义分类模型返回“技术”类别的置信度≥0.82。
3、在「执行动作」中选择「移动到文件夹」→「待响应-技术」，并勾选「标记为未读」与「高亮显示」。
4、保存规则，观察后续3小时内新邮件是否自动进入指定文件夹；若无反应，检查OpenClaw日志中是否有Rule '技术咨询邮件识别' skipped: confidence below threshold记录。
四、部署智能回复模板并绑定生效策略
固定式自动回复易被识别为垃圾邮件，需基于时间窗口、邮件标签及紧急程度动态启用，同时保留人工审核环节防止误发。
1、进入「自动化」→「自动回复」→「新建策略」，设定生效时段为工作日9:00–18:00之外，且排除标记为“紧急”或“客户VIP”的邮件。
2、编辑回复正文，插入变量：{{sender_name}}您好，您的邮件已收到，我们将在下一个工作日9:00前给予正式回复。
3、在「高级选项」中启用「仅对首次来信启用」并设置「最大发送次数：1次/发件人/7天」。
4、启用策略后，在测试邮箱发送一封不含“紧急”标签的新邮件，确认10秒内收到自动回复且原始邮件被标记为「已回复」。
五、启用附件文本提取与上下文联动处理
含PDF或Excel附件的邮件常携带关键业务信息，需在分类前完成内容解析，并将提取文本注入模型上下文，提升语义判断准确率。
1、在「自动化」→「附件处理」中启用「扫描新邮件附件」，添加识别条件：附件扩展名为.pdf或.xlsx，且文件大小在0.5MB–8MB之间。
2、勾选「启用OCR识别」以支持扫描版PDF，并设置「超时阈值：90秒」防止大文件阻塞队列。
3、在分类规则中引用提取结果：于「触发条件」新增「附件提取文本包含“合同金额”或“付款条款”」。
4、在「执行动作」中选择「生成工单」→「财务部-付款审核」，并自动附加原文链接与OCR文本摘要。
