开发OpenClaw邮件自动收发怎么配置 OpenClawIMAP/SMTP智能邮箱接案例|Duuu笔记
在生产环境中优化前端，本文分析
需同时配置IMAP与SMTP双通道：先设SMTP发信参数并重启服务；再启IMAP轮询并验证连接；接着配置SPF/DKIM/DMARC DNS记录；然后修复Docker网络连通性；最后在Win11中集成Windows凭据管理器启用IMAP。
如果您希望 OpenClaw 实现邮件自动收发功能，则需同时配置 IMAP（接收）与 SMTP（发送）双通道。以下是完成该功能的完整操作步骤：
一、配置 SMTP 发送通道
SMTP 配置是 OpenClaw 主动外发邮件的基础，必须提供有效的发信服务器地址、端口、认证凭据及加密协议设置，确保系统能通过标准邮件协议完成身份验证并建立安全连接。
1、使用 SSH 工具（如 OrcaTerm）登录 OpenClaw 服务器，确认当前位于
workspace
目录。
2、执行命令
nano config/default.json
打开默认配置文件。
3、在
"smtp"
节点下填入以下参数（以 QQ 邮箱为例）：
"host": "smtp.qq.com"
"port": 587
"secure": false
"auth": {"user": "your_email@qq.com", "pass": "your_16_digit_app_password"}
4、保存修改：按
Ctrl+O → Enter → Ctrl+X
退出编辑器。
5、执行
pm2 restart all
使 SMTP 配置生效。
二、启用 IMAP 接收通道
IMAP 配置允许 OpenClaw 主动轮询邮箱服务器，拉取新邮件并解析其中的自然语言指令。该通道依赖邮箱服务商开启 IMAP 访问权限，并使用应用专用密码进行身份校验。
1、登录对应邮箱网页版（如 QQ 邮箱），进入「设置 → 账户 → POP3/IMAP/SMTP」页面。
2、开启
IMAP/SMTP 服务
，并生成新的
16 位应用专用密码
（不可复用登录密码）。
3、返回服务器终端，在
config/default.json
中新增
"imap"
节点，内容如下：
"host": "imap.qq.com"
"port": 993
"secure": true
"auth": {"user": "your_email@qq.com", "pass": "your_16_digit_app_password"}
4、确认
"enable_imap_polling"
字段设为
true
，并设定轮询间隔（单位秒），例如：
"poll_interval": 60
5、重启服务后，执行
clawctl mail status
查看 IMAP 连接状态是否显示
connected
。
三、配置 DNS 安全策略（SPF/DKIM/DMARC）
若 OpenClaw 发出的邮件被收件方标记为垃圾邮件或拒收，大概率是域名发信权限未授权。需在云解析 DNS 控制台添加三项关键 TXT 记录，向全球邮件服务器声明本域合法发信来源与内容完整性保障机制。
1、添加 SPF 记录，格式为：
v=spf1 ip4:你的服务器公网IP -all
2、生成 DKIM 密钥对：在服务器执行
clawctl mail dkim-gen --domain yourdomain.com
，将输出的公钥字符串填入 DNS 的
default._domainkey.yourdomain.com
TXT 记录。
3、添加 DMARC 记录，格式为：
v=DMARC1; p=quarantine; rua=mailto:admin@yourdomain.com
4、全部记录添加完毕后，等待 DNS 全网生效（通常 10–60 分钟），再使用
mxtoolbox.com
验证三项记录是否正确发布。
四、容器化部署下的网络连通性修复
当 OpenClaw 运行于 Docker 容器中时，IMAP/SMTP 连接失败常因容器内 DNS 解析异常或防火墙拦截导致。需从容器网络栈层面排查并修复基础通信能力。
1、进入容器执行诊断命令：
docker exec -it
openclaw
/bin/sh
2、测试域名解析：
nslookup imap.qq.com
3、若解析失败，编辑
docker-compose.yml
，在 service 下添加显式 DNS 配置：
dns: ["119.29.29.29", "8.8.8.8"]
4、测试端口连通性：
timeout 5s telnet imap.qq.com 993
5、若超时，检查宿主机防火墙及云服务器安全组，确保
出站 TCP 993 和 465/587 端口
均处于放行状态。
五、Windows 11 环境下的本地 IMAP 启用
在 Windows 11 桌面版 OpenClaw 中启用邮件接收功能，需绕过系统级邮件客户端限制，直接调用底层 IMAP 库并与 Windows 凭据管理器集成，确保密码不硬编码于配置文件中。
1、以管理员身份运行 PowerShell，执行：
cmdkey /add:imap.qq.com /user:your_email@qq.com /pass:your_16_digit_app_password
2、修改
config/default.json
中的 IMAP 配置，将
"pass"
字段留空，并添加字段：
"use_windows_credential_manager": true
3、启动 OpenClaw 服务前，先执行：
clawctl mail init-win-cred
4、服务启动后，观察日志中是否出现
[IMAP] polling started at interval=60s
字样。
5、向已配置邮箱发送一封含明确指令的测试邮件（例如：“请将上周销售数据导出为 Excel 并发给我”），确认 OpenClaw 是否成功解析并执行。
