目录

采用的方案

第一步：获取 Google Cloud 凭据 (JSON 文件)

第二步：在 WSL 中进行授权

第三步：启用 OpenClaw 技能

连接 OpenClaw 到 Gmail 主要通过使用官方推荐的 gog (Google on Gateway) 插件来实现。这个插件允许 AI 智能体通过 Google Cloud API 安全地读取、搜索和管理你的邮件、日历及云端硬盘文件。

采用的方案

使用 Google 桌面应用 OAuth (Out of Band 流程)

第一步：获取 Google Cloud 凭据 (JSON 文件)

你需要为 OpenClaw 申请一个“通行证”：

1. 创建项目：访问 Google Cloud Console，创建一个新项目。

   登录谷歌云需要绑定visa信用卡，详细教程可参考https://juejin.cn/post/7352144724293976118

2. 启用 Gmail API：创建一个项目，在搜索栏搜索 "Gmail API" 并点击“启用”。

   

3. 配置 OAuth 同意屏幕：

   

   1. 在 Scopes (范围) 页面，添加对 Gmail 的访问权限（如 .../auth/gmail.readonly 或 .../auth/gmail.modify）。

   2. User Type 选择 External (外部)。

4. 创建 OAuth 客户端 ID：

   1. 前往“凭据”页面，点击“创建凭据” -> OAuth 客户端 ID。

   2. 应用类型选择 桌面应用 (Desktop App)。

   3. 下载生成的 JSON 文件，重命名为 google_client_secret.json。

第二步：在 WSL 中进行授权

将下载的 JSON 文件放入你的 WSL 目录中（建议放在 ~/.openclaw/credentials/ 下），然后执行以下命令：

1. 安装并导入凭据：

   # 如果没安装 gog 插件，先安装：npx clawhub@latest install gog 
   gog auth credentials ~/.openclaw/credentials/google_client_secret.json

2. 关联你的 Gmail 账号：

   gog auth add 你的邮箱@gmail.com --services gmail,calendar,drive

执行后，终端会给出一个 URL。在浏览器中打开它进行授权，然后将授权后的回调 URL（或显示的验证码）粘贴回终端即可。

点击链接后会有一个授权码，给到openclaw即可，自行配置

第三步：启用 OpenClaw 技能

1. 确认 Skill 文件：确保你的 ~/.openclaw/skills/ 目录下有 gog 或 google 相关的工具定义文件。

2. 将命令加白（安全检查）：

   openclaw approvals allowlist add "$(command -v gog)"

3. 重启服务：

   # pm2将程序自动运行在后台，长期稳定 
   pm2 restart openclaw

在后续使用过程中，发现openclaw会“忘事”

你可以提醒他，形成记忆，防止后续忘记