OpenClaw 邮箱收发配置要区分登录密码和授权码,再分别验证 IMAP、SMTP、收件、发件和自动处理规则。
一、先看整体关系
邮箱配置失败通常不是模型问题,而是协议、端口、授权码或安全策略没有对齐。
二、把风险边界先拆开
复杂任务要先看输入、权限、执行和输出的边界。边界清楚后,再写命令、接模型或接渠道,排错会更可控。
适用范围与准备项
本文以网易 163 邮箱为例,配置 OpenClaw 的收件与发件功能。邮箱端使用标准协议,OpenClaw 端使用本地脚本和环境变量完成调用。
| 项目 | 建议值 | 用途 |
|---|---|---|
| 收件协议 | IMAP 993 + SSL/TLS | 读取收件箱、同步状态 |
| 发件协议 | SMTP 465 + SSL/TLS | 发送测试邮件、通知邮件 |
| 登录凭证 | 163 授权码 | 同时用于 IMAP 和 SMTP |
| OpenClaw 运行方式 | 工作区脚本 + .env + prompt 或 cron | 让 Agent 可调用邮箱收发能力 |
第一步,登录 163 邮箱网页端
先打开 163 邮箱网页端并登录要接入 OpenClaw 的邮箱帐号。后续的 IMAP/SMTP 开关和授权码,都需要在网页端完成。

第二步,进入 POP3/SMTP/IMAP 设置页
进入邮箱主页后,在顶部菜单点击“设置”,再进入“POP3/SMTP/IMAP”。对于 OpenClaw 的邮箱收发配置,这一步是整个接入流程的起点。

第三步,开启 IMAP/SMTP 并完成验证
如果你的目标是在 OpenClaw 中读取邮件并发送邮件,优先开启 IMAP/SMTP。这组服务分别负责收件和发件,是本文的主路径。开启过程中如果出现安全提示或手机验证,按页面提示完成即可。
如果你还有兼容旧客户端的需求,可以额外开启 POP3/SMTP;但对 OpenClaw 的自动化收发来说,优先跑通 IMAP/SMTP 即可。
第四步,生成并保存 163 授权码
163 邮箱网页密码不适合直接放进 OpenClaw 工作区脚本。更稳妥的做法,是在协议设置页下方进入授权码管理,生成一枚新的授权码,并把它写入 .env。

这里最容易出错的地方只有一个:把网页登录密码当成脚本密码。163 邮箱在第三方客户端接入场景下,应优先使用授权码,而不是网页密码。
第五步,核对 IMAP 和 SMTP 服务器地址
OpenClaw 配置邮箱收发时,收件和发件不是同一个地址。收件通常使用 IMAP,发件通常使用 SMTP。
| 用途 | 服务器地址 | 端口 | 加密 |
|---|---|---|---|
| 收件 | imap.163.com | 993 | SSL/TLS |
| 发件 | smtp.163.com | 465 | SSL/TLS |
在 OpenClaw 端,授权码通常同时用于 IMAP 和 SMTP 登录。因此你只需要生成一枚新的授权码,并保证它没有被写错、复制错或过期失效。
第六步,在 OpenClaw 工作区写入邮箱参数
邮箱网页端配置完成后,就可以进入 OpenClaw 工作区。这里不建议把参数零散写进多个文件,第一版直接统一放到当前工作目录的 .env 里会更稳。
建议先按下面这份 .env 模板填写。这里把收件和发件参数放到同一套环境变量里,后面 OpenClaw 调用脚本时更省事。
OpenClaw 官方环境变量文档说明,当前工作目录中的 .env 会参与变量加载。这意味着你把邮箱参数写在工作区 .env 里之后,后续脚本和 Agent 调用都更容易复用。
第七步,放入收件脚本
收件脚本建议先做到两件事:一是能连上 163 IMAP,二是能输出结构化 JSON。这样 OpenClaw 后面无论是做摘要、分类还是晨报,都会更容易处理。
这段脚本完成后,可以先手动运行一次验证链路。只要返回 result = success,并能看到最近邮件的主题、发件人和时间,说明收件端已经跑通。
第八步,放入发件脚本
如果你的目标不只是“读邮件”,而是让 OpenClaw 还能主动发提醒、发测试邮件或发汇总邮件,就需要再放一份 SMTP 发件脚本。
建议先给自己的另一个邮箱发一封测试邮件,确认 SMTP 登录、发件人地址和收件人地址都没有问题。
第九步,让 OpenClaw 调用邮箱脚本
OpenClaw 端最稳的做法,不是先把脚本封成复杂技能,而是先让 Agent 直接在当前工作目录里调用脚本。这样最容易验证收件、发件和摘要链路是否真的可用。
收件测试提示词可以直接这样写:
发件测试提示词可以直接这样写:
对于第一次接邮箱的用户,建议遵循这个顺序:先跑收件脚本,再跑发件脚本,最后再叠加分类、摘要和定时任务。这样排错成本最低。
第十步,给 OpenClaw 增加邮件晨报任务
如果你希望 OpenClaw 每天定时汇总邮箱内容,可以直接用 Gateway 自带的 cron。当前官方文档推荐使用 openclaw cron add 配置周期任务。
如果你在 Windows 上通过 WSL2 运行 OpenClaw,官方文档也明确建议把 Gateway 作为用户服务安装并启动,再去执行 cron 相关命令:
也就是说,邮箱协议本身与 WSL 没有强绑定,但如果你后面要用 OpenClaw 的 cron、Gateway 或长期任务,WSL2 的 Gateway 服务状态就必须先正常。
参考资料
- OpenClaw Environment Variables
- OpenClaw Cron CLI
- OpenClaw Windows / WSL2
- 华为:163 邮箱 IMAP/SMTP 开启路径说明
- 华为云:常见邮箱 SMTP 服务器地址及端口
常见误区
把登录密码当授权码
多数邮箱要求使用单独授权码,直接填登录密码通常会失败。
只测收件不测发件
IMAP 和 SMTP 是两条链路,要分别验证。
自动规则过宽
邮件任务涉及真实收件箱,删除、转发和回复动作要保留确认环节。
方法对比
| 处理项 | 适合场景 | 确认重点 |
|---|---|---|
| IMAP | 收取邮件 | 确认端口和授权码 |
| SMTP | 发送邮件 | 单独测试发件 |
| 自动规则 | 整理和通知 | 先小范围试运行 |
用「Claw龙虾部署大师」减少前置配置成本
一键本地部署 用来处理 OpenClaw 安装、基础环境和本地运行入口,适合不想先花大量时间排查依赖的人。
模型接入 用来把豆包、通义千问、DeepSeek 等模型配置进工作流,适合需要先跑通 AI 助手底座,再继续配置渠道和任务的人。
本地安全部署 适合把数据、账号和运行环境留在本机或指定设备上,再按文章里的步骤继续收紧权限、接入渠道或验证任务。

提示