OpenClaw Gmail 集成：完整的电子邮件管理指南

简介

电子邮件管理是 OpenClaw 最强大的功能之一。通过 Gmail 集成，OpenClaw 可以读取您的电子邮件、对其进行分类、起草回复、存档邮件，并帮助您实现收件箱清零——所有这些都可以通过您的聊天应用程序完成。

本指南涵盖了将 OpenClaw 与 Gmail 集成并自动化电子邮件工作流程所需的一切。

对于其他集成，请参阅我们的指南：

• WhatsApp 设置
• 电报设置
• Discord 设置
• Slack 设置

为什么要集成 Gmail？

Gmail 集成提供了强大的电子邮件自动化功能：

• 收件箱管理 — 自动实现收件箱归零
• 智能分类 — 自动分类电子邮件
• 自动回复 — 起草并发送回复
• 电子邮件摘要 — 获取每日/每周摘要
• 搜索和过滤 — 快速查找电子邮件
• 附件处理 — 处理附件

先决条件

设置 Gmail 集成之前：

1. 已安装 OpenClaw — 请参阅安装指南
2. OpenClaw 配置 — 运行 openclaw onboard 以设置您的 AI 模型
3. Gmail 帐户 — 有效的 Gmail 或 Google Workspace 帐户
4. OAuth 设置 — 您将在下一步中进行配置

第 1 步：设置 Google OAuth

创建 Google Cloud 项目

1. 转到 Google Cloud Console：console.cloud.google.com
2. 创建新项目或选择现有项目
3. 为您的项目命名（例如“OpenClaw Gmail 集成”）
4. 点击“创建”

启用 Gmail API

1. 转到“API和服务”→“库”
2. 搜索“Gmail API”
3. 点击“Gmail API”
4. 点击“启用”

创建 OAuth 凭证

1. 转到“API 和服务”→“凭证”

2. 点击“创建凭证”→“OAuth 客户端 ID”

3. 配置 OAuth 同意屏幕（如果是第一次）：

   • 用户类型：外部（或工作区内部）
   • 应用程序名称：“OpenClaw”
   • 用户支持电子邮件：您的电子邮件
   • 开发者联系方式：您的电子邮件
   • 范围：添加 https://www.googleapis.com/auth/gmail.readonly 和 https://www.googleapis.com/auth/gmail.modify
   • 保存并继续

4. 创建 OAuth 客户端 ID：

   • 应用程序类型：“桌面应用程序”或“Web 应用程序”
   • 名称：“OpenClaw 桌面”
   • 授权重定向 URI：http://localhost:3000/oauth/callback（或您的 OpenClaw 回调 URL）
   • 点击“创建”

5. 复制客户端 ID 和客户端密钥 — 您将需要这些

配置 OpenClaw OAuth

OpenClaw 将引导您完成 OAuth，或手动配置：

openclaw config set gmail.oauth.clientId "your-client-id"
openclaw config set gmail.oauth.clientSecret "your-client-secret"

步骤 2：配置 OpenClaw

运行集成设置

启动 Gmail 集成：

openclaw integrations gmail

或者使用通用集成命令：

openclaw integrations
# Select Gmail from the menu

完整的 OAuth 流程

1. OpenClaw 将打开浏览器 或提供 URL
2. 使用您要连接的 Google 帐户登录
3. 查看权限 — OpenClaw 请求：
   • 阅读您的电子邮件
   • 代表您发送电子邮件
   • 管理您的电子邮件设置
4. 点击“允许”
5. 复制授权码（如果提供）
6. 将代码粘贴到 OpenClaw 终端提示符中

验证连接

你应该看到：

✓ Gmail integration configured successfully!
  Account: your.email@gmail.com
  Access: Read & Send

第 3 步：开始管理电子邮件

检查电子邮件

要求 OpenClaw 检查您的电子邮件：

Check my email

或者更具体一些：

Show me unread emails from the last 24 hours

阅读特定电子邮件

Read the email from Sarah

或者：

Show me the email about the meeting tomorrow

对电子邮件进行分类

OpenClaw 可以自动分类：

Categorize my inbox

类别可能包括：

• 重要
• 时事通讯
• 社交
• 促销活动
• 更新

存档电子邮件

Archive all emails older than 30 days

或者：

Archive all newsletters

删除电子邮件

Delete all promotional emails from last week
```**注意：** OpenClaw 在删除之前会要求确认。

## 高级功能

### 自动分类

启用自动电子邮件分类：

```bash
openclaw config set gmail.autoCategorize true
openclaw config set gmail.categories ["important", "newsletters", "social", "promotions"]

OpenClaw 会自动对收到的电子邮件进行分类。

收件箱零自动化

设置收件箱自动清零：

openclaw config set gmail.inboxZero.enabled true
openclaw config set gmail.inboxZero.schedule "daily"
openclaw config set gmail.inboxZero.actions.archive true
openclaw config set gmail.inboxZero.actions.delete true

OpenClaw 每天都会自动处理您的收件箱。

电子邮件摘要

获取每日或每周电子邮件摘要：

openclaw config set gmail.summaries.enabled true
openclaw config set gmail.summaries.frequency "daily"
openclaw config set gmail.summaries.time "08:00"

OpenClaw 将通过您连接的聊天应用程序发送摘要。

自动回复

配置自动响应：

openclaw config set gmail.autoReply.enabled true
openclaw config set gmail.autoReply.rules.outOfOffice true

OpenClaw 可以自动起草和发送回复（经过您的批准或在简单情况下自动发送）。

智能过滤器

创建智能过滤器：

openclaw config set gmail.filters.newsletters.action "archive"
openclaw config set gmail.filters.promotions.action "delete"
openclaw config set gmail.filters.important.action "star"

附件处理

OpenClaw 可以处理附件：

• 自动下载附件
• 从 PDF 中提取文本
• 处理图像和文档
• 总结附件内容

配置选项

电子邮件限制

配置要处理的电子邮件数量：

openclaw config set gmail.limits.maxEmailsPerRequest 50
openclaw config set gmail.limits.maxEmailsPerDay 1000

响应格式

配置电子邮件的显示方式：

openclaw config set gmail.format "summary"

选项：

• full — 完整电子邮件内容
• summary — AI 生成的摘要
• snippet — 仅 Gmail 代码段

隐私设置

配置隐私：

openclaw config set gmail.privacy.localOnly true
openclaw config set gmail.privacy.noCloudStorage true

通知设置

控制电子邮件通知：

openclaw config set gmail.notifications.enabled true
openclaw config set gmail.notifications.importantOnly true
openclaw config set gmail.notifications.quietHours "22:00-08:00"

用法示例

每日简报

设置每日电子邮件简报：

Send me a daily email briefing at 8 AM

OpenClaw 总结一下：

• 重要电子邮件
• 未读计数
• 行动项目
• 来自电子邮件的日历事件

电子邮件搜索

搜索您的电子邮件：

Find emails about the project proposal

或者：

Show me all emails from John in the last month

回复草稿

要求 OpenClaw 起草回复：

Draft a response to Sarah's email about the meeting

OpenClaw 将：

1. 阅读原邮件
2. 起草回应
3. 向您展示以获得批准
4. 批准后发送

电子邮件线程

处理电子邮件线程：

Show me the conversation thread about the budget

OpenClaw 可以跟踪并总结整个对话线索。

批量操作

执行批量操作：

Archive all emails from newsletters older than 7 days

或者：

Mark all emails from my team as important

故障排除

OAuth 错误

如果 OAuth 失败：

1. 检查凭据 — 验证客户端 ID 和密码
2. 检查重定向 URI — 必须完全匹配
3. 检查范围 — 确保请求所有必需的范围
4. 重新验证：

   openclaw integrations gmail --reauth

权限被拒绝

如果您看到权限错误：

1. 检查 OAuth 范围 — 确保授予 gmail.modify 范围
2. 重新授权 — 再次完成 OAuth 流程
3. 检查 Google 帐户 — 确保连接正确的帐户

电子邮件未加载

如果电子邮件未加载：

1. 检查 API 配额 — Gmail API 有每日配额

2. 检查连接：

   openclaw status

3. 检查日志：

   openclaw logs

4. 测试 Gmail API：

   openclaw test gmail

速率限制

如果您达到速率限制：

1. 降低请求频率：

   openclaw config set gmail.rateLimit 10

2. 使用批量操作 — 一次处理多封电子邮件

3. 检查 Gmail API 配额 — 在 Google Cloud Console 中监控

安全最佳实践

OAuth 安全

• 保密凭证 — 切勿分享客户端 ID/秘密

• 使用环境变量：

  export GMAIL_CLIENT_ID="your-id"
  export GMAIL_CLIENT_SECRET="your-secret"

• 轮换凭证 — 如果泄露则重新生成

电子邮件隐私

• 本地处理 — 尽可能在本地处理电子邮件
• 无云存储 — 除非明确配置
• 安全存储 — 凭证安全存储在 ~/.openclaw 中

访问控制- 限制权限 — 仅授予必要的范围

• 监控使用情况 — 定期检查 OpenClaw 日志
• 撤销访问权限 — 如果需要，请断开连接：

  openclaw integrations gmail --disconnect

高级用例

团队电子邮件管理

用于团队电子邮件：

• 共享收件箱 — 管理团队收件箱
• 电子邮件路由 — 将电子邮件路由给团队成员
• 响应模板 — 标准化响应

客户支持

用于客户支持：

• 自动回复 — 回答常见问题
• 票证创建 — 从电子邮件创建票证
• 升级 — 升级复杂问题

个人生产力

用于个人生产力：

• 收件箱归零 — 保持收件箱清洁
• 电子邮件摘要 — 每日/每周摘要
• 快速响应 — 快速电子邮件处理

与其他电子邮件服务的比较

Gmail 与 IMAP

• Gmail — OAuth、更好的 API、Gmail 特定功能
• IMAP — 适用于任何电子邮件提供商，更基本

OpenClaw 支持 Gmail API 和 IMAP。

后续步骤

现在 Gmail 已连接：

1. 探索其他集成 — WhatsApp、Telegram、Discord
2. 设置技能 — 技能库
3. 配置日历 — 与 Google 日历链接
4. 阅读常见问题解答 — 常见问题

结论

Gmail 集成将 OpenClaw 转变为强大的电子邮件管理助手。从收件箱零自动化到智能分类再到自动回复，OpenClaw 可以高效地处理您的电子邮件工作流程。 OAuth 设置非常简单，连接后，您可以从您最喜欢的聊天应用程序管理整个收件箱。

如需更多帮助，请查看我们的集成页面 或常见问题解答。使用 OpenClaw 轻松管理电子邮件！