OpenClaw邮件收发配置

# 案例 02：邮件收发

> 通过自然语言使用邮件收发功能

---

## 一、安装 Skill

```bash
# 安装
npx clawhub@latest install imap-smtp-email

# 安装依赖
cd ~/.openclaw/workspace/skills/imap-smtp-email
npm install
```

---

## 二、配置邮箱

### 2.1 运行配置脚本

```bash
cd ~/.openclaw/workspace/skills/imap-smtp-email
bash setup.sh
```

按提示选择邮箱服务商、输入邮箱地址和授权码。

### 2.2 获取授权码

**163 邮箱**：
1. 登录 https://mail.163.com
2. 设置 → POP3/SMTP/IMAP → 开启服务
3. 点击「客户端授权码」→ 验证手机号 → 设置授权码

**Gmail**：
1. 启用两步验证
2. 访问 https://myaccount.google.com/apppasswords
3. 生成 App Password

### 2.3 常用邮箱配置

| 邮箱 | IMAP 服务器 | SMTP 服务器 |
|------|------------|------------|
| 163.com | imap.163.com | smtp.163.com |
| 126.com | imap.126.com | smtp.126.com |
| QQ 邮箱 | imap.qq.com | smtp.qq.com |
| Gmail | imap.gmail.com | smtp.gmail.com |

---

## 三、通过对话使用

配置完成后，直接用自然语言与 OpenClaw 对话即可。

### 发送邮件

```
用户: 发送邮件给 zhangsan@example.com，主题是"项目进度"，内容是"本周完成了核心功能开发"
AI: ✅ 邮件已发送成功！
```

```
用户: 给小组群发邮件，主题"周报提醒"，内容"请各位今天下班前提交周报"
AI: ✅ 已发送给 5 位收件人...
```

```
用户: 把 /tmp/report.pdf 发送给 boss@company.com，主题是"月度报告"
AI: ✅ 邮件已发送，附件: report.pdf
```

### 检查邮件

```
用户: 帮我检查一下有没有新邮件
AI: 📬 您有 3 封未读邮件：
    1. 张三 - 项目进度更新
    2. 李四 - 会议邀请
    3. 系统通知 - 服务器告警
```

```
用户: 最近一小时有新邮件吗？
AI: 有 1 封新邮件：
    发件人: alert@monitor.com
    主题: CPU 使用率告警
```

### 搜索邮件

```
用户: 帮我找一下张三发的邮件
AI: 找到 5 封来自张三的邮件：
    1. [03-15] 项目进度更新
    2. [03-14] 需求确认
    ...
```

```
用户: 搜索主题包含"报告"的邮件
AI: 找到 3 封邮件：
    1. [03-16] 月度报告
    2. [03-10] 测试报告
    ...
```

### 读取邮件

```
用户: 帮我读一下张三最新的那封邮件
AI: 📧 邮件内容：
    发件人: 张三 <zhangsan@example.com>
    时间: 2026-03-18 14:30
    主题: 项目进度更新

    内容:
    你好，本周项目进度如下...
```

### 下载附件

```
用户: 下载最新邮件的附件
AI: ✅ 已下载附件到 ~/Downloads：
    - report.pdf (2.3MB)
```

---

## 四、多账户使用

如果配置了多个邮箱账户：

```
用户: 用工作邮箱给 client@company.com 发邮件，主题"合作方案"
AI: ✅ 已使用 work 账户发送邮件
```

```
用户: 检查一下我的 163 邮箱有什么新邮件
AI: 📬 163 邮箱有 2 封未读邮件...
```

---

## 五、常见问题

| 问题 | 原因 | 解决方案 |
|------|------|---------|
| 认证失败 | 使用了登录密码 | 163/126 用授权码，Gmail 用 App Password |
| 连接超时 | 网络问题 | 检查网络或防火墙 |
| 文件访问拒绝 | 白名单限制 | 配置时添加目录到白名单 |

---

## 六、安全建议

- ✅ 使用授权码，不要使用登录密码
- ✅ 定期更换授权码（建议 3-6 个月）
- ✅ 敏感邮件内容注意保密

---

[返回目录](../openclaw-enterprise-hands-on-guide.md)

*最后更新：2026-03-18*