📌 项目简介

AI 邮件秘书 是一个基于 OpenClaw 构建的智能 Agent，能够自动检查你的邮箱、分析邮件内容、按预设规则生成回复并发送。它像一位 24 小时在线的专业秘书，帮你从重复性的邮件处理工作中解放出来，让你专注真正重要的事。

✅ 一句话目标：捏一个懂行的"职场嘴替"，让 AI 代劳邮件回复。

✨ 核心功能

功能	说明
📬 定时检查邮件	每 10 分钟自动扫描收件箱未读邮件（频率可调）
🧠 智能意图分析	AI 判断邮件是咨询、协作、通知还是垃圾
✍️ 自动生成回复	礼貌专业的回复，语气与来信风格保持一致
⚖️ 分级处理策略	常规邮件直接回复；重要邮件生成草稿待审核
🚫 垃圾邮件过滤	自动标记已读并归档，避免干扰
🔐 安全红线机制	VIP/紧急邮件绝不自动发送，杜绝 AI 误判

---

📁 项目结构

OpenClaw/
├── agent_config.yaml   # Agent 核心配置文件（必须）
├── README.md           # 使用说明书（本文件）
└── LICENSE             # 开源许可证

---

🚀 快速上手（以 163 邮箱为例）

本作品测试邮箱为：dxxx****@163.com（示例邮箱），配置已针对 163 邮箱优化。

第一步：克隆项目

cd OpenClaw

第二步：安装 OpenClaw 邮件技能

cd ~/.openclaw/workspace
npx playbooks add skill openclaw/skills --skill imap-smtp-email

第三步：获取 163 邮箱授权码

⚠️ 安全提醒：163 邮箱必须使用授权码登录第三方客户端，不能使用邮箱密码！

1. 登录 163 邮箱网页版 https://mail.163.com/

2. 点击 设置 → POP3/SMTP/IMAP 

3. 开启 IMAP/SMTP 服务（如果未开启）

4. 点击 新增授权码，按提示发送短信验证

5. 复制生成的 16 位授权码（形如 ABCDEFGHIJKLMNOP）

第四步：设置环境变量

在运行 OpenClaw 的终端中执行（或者你直接发给OpenClaw说下面是授权码）：

export EMAIL_AUTH_CODE="你刚才复制的16位授权码"

第五步：将 Agent 配置载入 OpenClaw

cp agent_config.yaml ~/.openclaw/agents/email-secretary.yaml

第六步：启动 OpenClaw 并激活 Agent

启动 OpenClaw 后，在对话界面中激活你的 Agent：

/agent email-secretary

现在 Agent 就会按照心跳频率自动检查你配置的邮箱的邮件了！

---

⚙️ 配置详解

心跳频率调整

修改 agent_config.yaml 中的 heartbeat.every 字段：

heartbeat:
  every: "10m"   # 支持 5m, 10m, 30m, 1h 等格式

更换邮箱地址

修改 agent_config.yaml 中的以下字段为你的邮箱和授权码（授权码建议通过环境变量设置）：

IMAP_USER: "你的邮箱@163.com"
SMTP_USER: "你的邮箱@163.com"
# 密码/授权码建议通过环境变量 EMAIL_AUTH_CODE 设置，不要直接写在配置文件里

支持的邮箱服务商对照表

邮箱	IMAP 服务器	SMTP 服务器
163 邮箱	imap.163.com	smtp.163.com
Gmail	imap.gmail.com	smtp.gmail.com
Outlook	outlook.office365.com	smtp.office365.com
QQ 邮箱	imap.qq.com	smtp.qq.com

---

💬 使用示例

场景：常规咨询邮件自动回复

收到邮件：

发件人：friend@example.com
主题：周末有空吗？
内容：Hi，这周末有空一起讨论下项目方案吗？

Agent 自动回复：

收件人：friend@example.com
主题：Re: 周末有空吗？

内容：
您好，

感谢您的来信。关于周末讨论项目方案的事宜，我目前的时间安排是
周六下午两点后有空。如果这个时间方便，我们可以通过线上会议沟通。

期待您的回复。

祝好，
AI 邮件秘书（代发）

❓ 常见问题

Q1：Agent 没有自动检查邮件怎么办？

A：请检查：

• 是否通过 /agent email-secretary 激活了 Agent

• 环境变量 EMAIL_AUTH_CODE 是否正确设置

• 邮箱的 IMAP/SMTP 服务是否已开启

Q2：邮箱提示"登录失败"或"授权码错误"？

A：请确认使用的是授权码而非邮箱密码，且授权码前后无空格。对于163邮箱，务必在网页端生成专用授权码。

Q3：如何临时停止自动回复？

A：在 OpenClaw 对话中输入 /agent stop 即可暂停 Agent。

Q4：邮件附件怎么处理？

A：当前版本主要处理邮件正文，附件暂不深度分析。你可以在 soul 字段中添加规则来扩展附件处理能力。