📧 OpenClaw 配置 QQ 邮箱发送教程

前言

OpenClaw 内置了 qq-email-sender 技能，可以让 AI 助手直接帮你发送邮件。本教程将手把手带你完成从开启 QQ 邮箱 SMTP 授权到成功发送邮件的全过程。

---

第一步：开启 QQ 邮箱 SMTP 服务

⚠️ QQ 邮箱默认关闭 SMTP，必须手动开启并获取授权码（不是 QQ 密码）

1. 登录 QQ 邮箱：https://mail.qq.com

2. 点击顶部 设置 → 账户

3. 向下滚动找到 POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务

4. 找到 SMTP服务，点击 开启

5. 按提示用手机发送短信验证

6. 验证成功后会显示一串授权码（格式类似：abcdefghijklmnop）

   📌 务必保存这个授权码！ 它只显示一次，后续配置需要用到

---

第二步：配置 OpenClaw 技能

技能配置文件位于：

C:\Users\你的用户名\.qclaw\workspace\skills\qq-email-sender\config.json

编辑 config.json，填入你的信息：

{
  "email": {
    "smtpServer": "smtp.qq.com",
    "smtpPort": 465,
    "senderEmail": "你的QQ号@qq.com",
    "senderName": "OpenClaw",
    "authCode": "刚才获取的授权码",
    "receiverEmail": "默认收件人@qq.com"
  }
}

字段说明

字段	说明	示例
smtpServer	SMTP 服务器地址	smtp.qq.com
smtpPort	端口（SSL 用 465）	465
senderEmail	发件人邮箱	123456@qq.com
senderName	发件人显示名称	OpenClaw
authCode	QQ 邮箱授权码	abcdefghijklmnop
receiverEmail	默认收件人	123456@qq.com

---

第三步：测试发送

配置完成后，可以用以下方式测试：

方式一：命令行测试

cd C:\Users\你的用户名\.qclaw\workspace\skills\qq-email-sender

# 发送测试邮件
node index.js --test

成功输出：

✅ 邮件发送成功！
收件人: 123456@qq.com
主题: OpenClaw 测试邮件

方式二：直接对 AI 说

配置完成后，直接对 OpenClaw 说：

帮我发一封邮件给 xxx@qq.com，主题是"测试"，内容是"Hello"

---

第四步：常用发送场景

发送普通文本邮件

帮我发邮件给 xxx@qq.com，主题：会议通知，内容：明天下午3点开会

发送 HTML 格式邮件

帮我发一封 HTML 格式的邮件给 xxx@qq.com，内容要有标题和表格

发送带附件的邮件

帮我把桌面上的 report.pdf 发送给 xxx@qq.com

批量发送

帮我给以下邮箱发送同一封邮件：a@qq.com, b@163.com, c@gmail.com

---

常见问题

❌ 报错：Authentication failed

原因：授权码填写错误，或填写了 QQ 密码
解决：重新到 QQ 邮箱设置页面生成新的授权码，注意授权码中间没有空格

❌ 报错：Connection timeout

原因：网络问题或端口被防火墙拦截
解决：

• 确认端口 465 未被封锁
• 尝试改用端口 587（需同时将 smtpPort 改为 587）

❌ 邮件进了垃圾箱

原因：发件人信誉度问题
解决：在收件人邮箱将发件地址加入白名单

---

扩展：支持其他邮箱

只需修改 config.json 中的 SMTP 配置即可支持其他邮箱：

邮箱	SMTP 服务器	端口
QQ 邮箱	smtp.qq.com	465
163 邮箱	smtp.163.com	465
Gmail	smtp.gmail.com	587
Outlook	smtp.office365.com	587

---

总结

配置步骤回顾：

1. ✅ QQ 邮箱开启 SMTP 服务，获取授权码
2. ✅ 编辑 config.json 填入邮箱信息
3. ✅ 测试发送验证配置正确
4. ✅ 直接对 AI 说话即可发送邮件

配置完成后，你就可以让 OpenClaw 帮你自动发送邮件通知、报告、提醒等各种场景了 🎉

---

作者：iomelons
博客：https://iomelons.github.io
GitHub：https://github.com/iomelons