邮件是信息过载的重灾区。通过 OpenClaw 接入邮件，AI 助手可以帮你自动分类、提炼摘要、标记重要邮件，甚至起草回复。
支持的邮件方式
| 方式 | 说明 |
|---|---|
| Gmail API | OAuth 授权，功能最完整 |
| IMAP | 通用协议，支持所有邮件服务 |
| Webhook | 邮件服务推送新邮件通知 |
方式一：Gmail API 配置
Step 1：创建 Google Cloud 应用
- 访问 console.cloud.google.com
- 创建新项目（或使用已有项目）
- 启用 Gmail API
- 创建 OAuth 2.0 凭据（Desktop app 类型）
- 下载
credentials.json
Step 2：配置 OpenClaw
bash
openclaw configure --section emailjson
// ~/.openclaw/config.json
{
"integrations": {
"gmail": {
"enabled": true,
"credentialsPath": "~/.openclaw/gmail-credentials.json",
"checkIntervalMinutes": 15,
"labels": ["INBOX", "UNREAD"],
"maxResults": 20
}
}
}方式二：IMAP 配置（通用）
json
{
"integrations": {
"imap": {
"enabled": true,
"host": "imap.gmail.com",
"port": 993,
"ssl": true,
"username": "you@gmail.com",
"password": "你的应用专用密码",
"folder": "INBOX",
"checkIntervalMinutes": 10
}
}
}Gmail 需要开启「两步验证」并生成「应用专用密码」。
配置 Heartbeat 邮件检查
markdown
# HEARTBEAT.md
## 邮件检查（每 2 小时）
读取未读邮件，按以下规则处理：
### 重要性判断
- URGENT（立刻通知）：来自老板/重要客户 + 主题含「urgent/ASAP/紧急」
- HIGH：来自同事、有截止日期的邮件
- NORMAL：其他业务邮件
- LOW：通讯、广告、订阅邮件
### 处理方式
- URGENT：立刻发 Telegram 通知，附邮件摘要（3 句话）
- HIGH：在当天的日报里汇总
- NORMAL/LOW：仅统计数量
### 安全规则
- 绝不自动发送邮件回复
- 只读取，不移动或删除邮件
- 可以起草回复但需要我确认才发送智能邮件摘要（Cron 日报）
bash
# 每天 18:00 发当日邮件日报
openclaw cron add \
--schedule '0 18 * * *' \
--task '读取今天收到的所有邮件，生成日报：
1. 需要回复的（按优先级）
2. 需要行动的（有截止日期）
3. 仅供参考的
4. 可以忽略的
发送到 Telegram'自动回复草稿
# 在 Telegram 里发消息
你：帮我草拟一封回复，回复 john@example.com 刚才的邮件，
说我下周三可以开会，上午 10 点
助手：好的，这是草稿：
------
Hi John,
Thanks for reaching out...
------
需要我修改什么吗？确认后可以帮你发送。
你：发送
助手：邮件已发送。
安全配置（防误发）
json
{
"integrations": {
"gmail": {
"sendEnabled": true,
"requireConfirmation": true,
"confirmationTimeout": 60,
"draftMode": false
}
}
}关键安全规则：
requireConfirmation: true：发邮件前必须确认draftMode: true：只创建草稿，需要手动发送- 在 CLAUDE.md 里写明：「未经确认不得发送任何邮件」
常见问题
Q：Gmail 提示安全警告 使用「应用专用密码」而非主密码，在 Google 账号安全 -> 应用专用密码 生成。
Q：邮件太多，检查很慢
限制 maxResults 和 labels，只检查 UNREAD+INBOX，避免处理所有历史邮件。
Q：想让 AI 自动处理某类邮件（如账单） 在 HEARTBEAT.md 里写规则：「主题含 Invoice 的邮件，提取金额和截止日期， 记录到 ~/expenses.csv」
来源：OpenClaw 官方文档 | Gmail API 文档