若smtp配置失败，需依次完成四步：一、登录qq邮箱获取并保存16位授权码；二、在workbuddy中填入smtp.qq.com、端口465、邮箱地址及授权码；三、通过claw模式用自然语言指令自动配置；四、发送测试邮件验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装WorkBuddy过程中需要启用邮件告警功能，但SMTP服务器参数配置失败，则可能是由于服务器地址、端口或认证信息未正确匹配邮箱服务商要求。以下是完成该配置的具体操作步骤：
一、获取并验证QQ邮箱SMTP授权码
该步骤确保您拥有合法且有效的发信凭证，避免因使用登录密码或授权码过期导致连接被拒。QQ邮箱强制要求使用独立生成的16位授权码进行SMTP认证，不可用账户密码替代。
1、访问mail.qq.com并使用QQ账号登录。
2、点击右上角头像，进入【设置】→【账户】，向下滚动至【POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务】区域。
3、勾选【开启SMTP服务】，按提示完成手机短信验证。
4、验证成功后，系统弹出16位授权码窗口，必须立即复制并保存，关闭页面后无法再次查看。
二、填写WorkBuddy SMTP核心参数
该步骤将授权码与服务器通信参数绑定，构成完整的发信链路。参数值必须严格对应QQ邮箱官方标准，任意一项错误均会导致“认证失败”或“连接超时”错误。
1、在WorkBuddy安装向导或【设置】→【邮箱账户】中，定位SMTP配置表单。
2、依次填入以下四项：smtp.qq.com（服务器地址）、465（端口）、您的完整QQ邮箱地址（如123456@qq.com）、刚复制的16位授权码。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
3、确认端口465对应SSL加密模式，不可填写587或25，否则将触发协议不匹配错误。
三、切换至Claw模式执行指令式配置
该方式绕过手动填表，通过自然语言指令驱动WorkBuddy自动解析并写入全部参数，降低人为输入失误风险，适用于对SMTP概念不熟悉的用户。
1、启动WorkBuddy客户端，点击界面顶部【Claw】按钮切换至智能代理模式。
2、在聊天框中输入：请帮我配置QQ发件邮箱，SMTP服务smtp.qq.com，端口465，邮箱xxx@qq.com，授权码xxxxxxxxxxxxxxxx。
3、系统自动校验格式并提交配置，若提示“参数已加载”，表示SMTP服务注册成功。
四、执行链路连通性测试
该步骤验证从WorkBuddy到目标邮箱服务器的全路径是否可达，排除防火墙拦截、DNS解析失败或服务商限流等底层网络问题。
1、在SMTP配置界面底部，点击【发送测试邮件】按钮。
2、输入一个可接收邮件的验证地址（建议使用同一QQ邮箱或其他常用邮箱）。
3、等待30秒内收到标题含“WorkBuddy SMTP测试”的邮件，收到即表明告警通道已就绪；若超时未达，需检查本地网络出站465端口是否被企业防火墙阻断。
