需验证本地模型服务、校准imap配置、安装邮件技能、调试分类提示词、检查回复草稿生成机制。具体包括：确认模型运行与openclaw连接正常；使用应用密码或oauth2配置邮箱；安装email-processor等技能并启用；优化prompt明确分类枚举项；确保generate_reply开启且草稿箱权限正确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在不依赖云端服务的前提下，利用本地运行的大模型完成邮件撰写、自动分类与智能回复，可能面临模型接入异常、邮件内容解析失败或分类逻辑不匹配等问题。以下是解决此问题的步骤：
一、验证本地大模型服务状态与OpenClaw连接
确保大模型推理服务已启动且OpenClaw能正常调用，是后续所有邮件处理功能生效的前提。若模型未就绪，分类与回复将无法生成。
1、检查本地模型服务进程是否运行，例如使用ollama list确认Qwen3.5-9B或GLM-4.7-Flash处于active状态。
2、执行openclaw models list命令，验证OpenClaw是否识别到已配置的本地模型提供方（如qwen-local或local-glm）。
3、手动发送测试请求至模型API端点，例如用curl向http://localhost:8000/v1/chat/completions提交最小化JSON载荷，确认返回200 OK及有效响应体。
4、若连接失败，检查~/.openclaw/openclaw.json中baseUrl地址是否与模型服务实际监听地址一致，特别注意端口是否被防火墙拦截或被其他进程占用。
二、校准IMAP邮箱配置与权限凭证
OpenClaw需通过IMAP协议安全拉取原始邮件数据，配置错误将导致无法读取收件箱，使分类与回复流程中断于第一步。
1、确认邮箱服务商是否启用IMAP支持，Gmail需在“设置→转发和POP/IMAP”中开启IMAP访问。
2、使用应用专用密码替代主密码进行认证，例如Gmail需在“安全性→两步验证→应用专用密码”中生成16位密码。
3、编辑openclaw.json中的email段落，确保host、port、tls与服务商文档一致，禁止在配置文件中明文写入密码，应改用环境变量如MAIL_PASSWORD。
4、对支持OAuth2的企业邮箱（如Outlook），必须完整填写oauth2对象，包括clientId、clientSecret和refreshToken，否则连接将被拒绝。
三、部署并启用邮件处理技能模块
OpenClaw自身不具备原生邮件处理能力，必须安装对应Skill才能执行读取、分类、生成草稿等动作，缺失模块将导致流程无响应。
1、运行clawhub install email-processor安装基础邮件处理技能包。
OpenClaw 原生 PDF/文档处理技能，适用于 Nutrient DWS，帮助用户完成 PDF 转换、OCR、文字/表格提取、PII 脱敏等功能。
2、如需附件文本提取能力，追加安装clawhub install attachment-extractor。
3、执行openclaw skills list确认已安装技能状态为enabled，若显示disabled则运行openclaw skills enable email-processor。
4、检查技能配置路径，确保templates目录存在且包含合法的Jinja2格式回复模板文件，模板文件名必须以.j2结尾，否则加载失败。
四、调试分类提示词与优先级判定逻辑
分类结果不准确通常源于模型输入提示词（prompt）未能清晰传达业务规则，导致大模型按通用语义而非实际需求归类。
1、定位分类逻辑所在文件，常见路径为~/.openclaw/skills/email-processor/prompt/classify.j2。
2、检查提示词中是否明确列出分类维度，例如是否包含发件人白名单、时间敏感词列表（如“今日截止”“24小时内”）、动作动词（如“审批”“签字”“确认”）。
3、临时缩短提示词长度，移除冗余说明，仅保留核心指令句：“请将以下邮件归入以下五类之一：紧急事务、常规工作、订阅资讯、垃圾邮件、待确认邮件。”
4、在测试模式下运行单封邮件分类，捕获模型原始输出，若返回非预设类别名称（如出现“重要”“一般”等模糊词），说明提示词约束力不足，需强制限定输出格式为枚举值。
五、验证回复草稿生成与草稿保存机制
即使分类正确，若回复生成阶段失败或草稿未成功写入邮箱客户端，用户仍将面对空白草稿箱，误判为系统无响应。
1、确认email-processor技能中是否启用了generate_reply动作，检查其配置项enable_reply_generation是否设为true。
2、检查模型调用参数中stop_sequences是否包含"\n\n"或"
3、在Thunderbird或Outlook客户端中确认“草稿”文件夹是否存在且可写入，部分企业邮箱策略会禁用第三方应用写入草稿箱。
4、查看OpenClaw日志输出（openclaw logs --tail 50），搜索关键词create_draft或reply_generated，若日志中出现draft creation failed: permission denied，需联系IT部门开通IMAP草稿写入权限。
