必须同步配置imap与smtp双通道:先设smtp发信参数并重启服务,再启imap轮询并验证连接,接着配置spf/dkim/dmarc dns记录,然后修复docker网络连通性,最后在win11中集成windows凭据管理器启用imap。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让OpenClaw真正收发邮件,必须同步打通IMAP(收信)与SMTP(发信)两个通道,缺一不可;只配一个会导致指令能发但无人响应,或邮件能收却无法自动回复。
配置SMTP发信通道
SMTP是OpenClaw对外发送邮件的唯一出口,不设好它,所有“自动回复”“审批通知”类功能全部失效。
第一步:用SSH工具(如OrcaTerm)登录OpenClaw服务器,确认当前路径为workspace目录。
第二步:执行命令nano config/default.json打开默认配置文件。
第三步:在"smtp"节点下填入完整参数(以QQ邮箱为例):
"host": "smtp.qq.com"
"port": 587
"secure": false
"auth": {"user": "your_email@qq.com", "pass": "your_16_digit_app_password"}
注意:【pass字段必须填16位应用专用密码,绝不能用邮箱登录密码】,QQ邮箱网页端「设置→账户→POP3/IMAP/SMTP」里可生成,填错将导致pm2重启后持续报错AUTH_FAILED。
第四步:按Ctrl+O → Enter → Ctrl+X退出编辑器并保存。
第五步:执行pm2 restart all使SMTP配置立即生效。
启用IMAP收信轮询
IMAP不是配完就通的单次操作,它依赖持续心跳连接。轮询间隔设太短会触发邮箱服务商限流,设太长则指令响应延迟明显。
方法一:网页端前置开通
登录QQ邮箱网页版→进入「设置→账户→POP3/IMAP/SMTP」→开启IMAP服务→生成新的16位应用专用密码(与SMTP用同一组密码即可)。
方法二:服务端补全配置
回到服务器终端,在config/default.json中新增"imap"节点:
"host": "imap.qq.com"
"port": 993
"secure": true
"auth": {"user": "your_email@qq.com", "pass": "your_16_digit_app_password"}
同时确认"enable_imap_polling"设为true,并设定"poll_interval": 60(单位秒,建议60~180之间)。
方法三:验证连接状态
重启服务后,直接执行clawctl mail status。若输出中imap_status显示connected且last_poll_time为近1分钟内时间戳,说明IMAP已活。
补充关键DNS记录
仅配置客户端参数还不够——如果OpenClaw发出的邮件被Gmail或Outlook标记为垃圾邮件,90%概率是域名身份认证缺失。
登录你的域名DNS管理后台(如阿里云、Cloudflare),添加三条TXT记录:
① SPF记录:v=spf1 include:qq.com ~all(适配QQ邮箱发信域)
② DKIM记录:从QQ邮箱「设置→账户→域名邮箱→DKIM」获取指定selector值和公钥,拼成selector._domainkey.yourdomain.com格式记录
③ DMARC记录:v=DMARC1; p=none; rua=mailto:postmaster@yourdomain.com
这三项生效需最长48小时,但配置后clawctl mail test发往Gmail的测试邮件将不再进垃圾箱。
修复Docker网络连通性
很多用户卡在IMAP连接超时,根本原因不是密码错,而是容器内无法解析imap.qq.com或访问993端口。
执行docker exec -it openclaw-container ping imap.qq.com,若提示unknown host,说明DNS解析失败;若能ping通但telnet imap.qq.com 993卡住,则是防火墙或宿主机网络策略拦截。
临时修复:编辑/etc/docker/daemon.json,加入"dns": ["8.8.8.8", "114.114.114.114"],然后sudo systemctl restart docker。
永久方案:在OpenClaw容器启动命令中显式添加--dns 8.8.8.8参数,并确保宿主机iptables未DROP 993端口。
Win11集成Windows凭据管理器
这是Windows部署场景下的特有步骤:若跳过此步,IMAP登录会因系统级凭据缓存冲突反复中断。
打开Win11「控制面板→用户账户→凭据管理器→Windows凭据→添加Windows凭据」。
Internet地址填imap.qq.com,用户名填完整邮箱your_email@qq.com,密码粘贴16位应用专用密码。
这一步做完后,OpenClaw服务在Win11上首次调用IMAP时,不会再弹出系统级认证窗口阻塞流程。










