← 返回教程

连接 Google Workspace

前置条件（两种方法通用）

1

创建 Google Cloud OAuth 凭据

此步骤在浏览器中完成 —— 暂无需在 MyClaw 实例上操作。

  1. 打开 Google Cloud Console → APIs 和服务 → 凭据。
  2. 点击 + 创建凭据 → OAuth 客户端 ID → 应用类型：桌面应用。
  3. 点击创建 → 下载 JSON。保存 client_secret_xxx.json 文件，下一步会用到。
打开 Google Cloud Console

你还需配置 OAuth 同意屏幕，并在 APIs 和服务 → OAuth 同意屏幕 → 测试用户中添加自己。否则授权会失败。

2

启用 Gmail API 和 Google Calendar API

点击下方链接并启用，每个只需几秒。

启用 Gmail API启用 Google Calendar API

只需要日历？仅启用 Calendar API 即可（后续步骤中加上 --services calendar）。

无需命令。在聊天窗口（Telegram / 网页聊天）中完成一切。

B.1

让 OpenClaw 安装 gog

OpenClaw
你
帮我安装 gog
OpenClaw
正在安装... ✅ gog v0.11.0 安装完成！
B.2

发送凭据文件

OpenClaw
你
client_secret_xxx.json
连接我的 Gmail 和 Calendar
OpenClaw
收到凭据文件，正在配置... ✅ 凭据已导入。你的 Gmail 地址是？
B.3

提供邮箱，获取授权链接

OpenClaw
你
your@gmail.com
OpenClaw
请在浏览器中打开此链接完成授权： https://accounts.google.com/o/oauth2/auth?... 授权后页面会跳转到 127.0.0.1 并显示错误 —— 这是正常的。从地址栏复制完整 URL 发给我即可。
B.4

粘贴回调 URL

OpenClaw
你
http://127.0.0.1:42845/oauth2/callback?state=xxx&code=xxx...
OpenClaw
✅ Gmail + Calendar 已连接！ 你现在可以直接说： • 「查看我最近的邮件」 • 「明天下午 3 点创建一场会议」

就这么简单 —— 发三条消息即可完成连接。

你现在可以做什么

功能直接说
📧 查收邮件「查看我最近的邮件」/「有来自 xxx 的邮件吗？」
📧 发送邮件「发封邮件给 a@b.com，关于...」
📅 查看日历「这周我有什么安排？」
📅 创建日程「周五下午 2 点安排一场会议」
📧 起草邮件「起草一封回复那封邮件」

故障排除

Q: 授权时出现「访问被阻止」或「应用未验证」

A: 你没有在 OAuth 同意屏幕中添加自己为测试用户。返回步骤 1，打开 OAuth 同意屏幕 → 测试用户，添加你的 Gmail 地址。

Q: 403 accessNotConfigured 错误

A: API 未启用。返回步骤 2，确认 Gmail API 和 Calendar API 均显示「已启用」。

Q: 回调 URL 已过期

A: 重新执行授权步骤即可，很快。告诉 OpenClaw「重新授权」，它会给你新的链接。

Q: WebSSH 中出现 no TTY available for keyring 错误

A: 在命令前加上 GOG_KEYRING_PASSWORD="anypassword"，例如：

GOG_KEYRING_PASSWORD="mypass123" gog auth add your@gmail.com ...