开始之前

Google 集成配置 = Google Cloud Console 里 4 步 + Kura酱 仪表盘里 2 步,共 6 步。约 15 分钟,不需要熟悉 Google Cloud。

准备好这些

1. 一个 Google 账户

   要连接的那个账户本身。推荐用个人账户。公司或学校所有的 Google Workspace 账户可能要先经管理员审批。

2. Kura酱 在运行

   picoclaw 或 launcher 进程已启动,仪表盘可在 http://localhost:8080 打开。

3. 浏览器允许 Cookie 和弹窗

   OAuth 同意会在新标签页打开 Google 的页面。隐身模式或某些隐私扩展可能拖累同意流程,建议在普通窗口完成。

4. 15 分钟的专注时间

   中途暂停不影响结果,但步骤 4 生成的 Client Secret 只显示一次,推荐至少把步骤 4-5 一气呵成。

为什么要”自带 OAuth 客户端”

Kura酱 没有提供共享的 OAuth 应用。改用 BYO 凭据(Bring Your Own credentials) 方式: 你在自己的 Google Cloud 项目里创建 OAuth 客户端,用这套凭据。

三个理由值得这 15 分钟:

1. 数据不经第三方。OAuth 客户端是你的,令牌和 API 流量直接走你 → Google。
2. 权限完全透明。可以在自己的 Google Cloud Console 里查看具体启用了哪些权限。
3. 撤销彻底干净。删除 OAuth 客户端,Kura酱 运营方也无法恢复(因为压根没保管)。

代价就是首次配置耗 15 分钟。一次配好,长期使用。

Workspace 账户能用吗?

能,但如果 Workspace 管理员禁止「创建/使用外部 OAuth 应用」,步骤 1 的项目创建就会被拦。这种情况下,用另一个个人 Google 账户创建 OAuth 客户端,步骤 6 时改用该个人账户进行连接即可。

整体流程

步骤	在哪里	做什么
1	Google Cloud Console	创建 GCP 项目
2	Google Cloud Console	启用 Gmail / Calendar / Drive 的 3 个 API
3	Google Cloud Console	配置 OAuth 同意屏幕
4	Google Cloud Console	创建 OAuth 客户端 ID(桌面应用),复制凭据
5	Kura酱 仪表盘	粘贴 Client ID / Client Secret
6	Kura酱 仪表盘 + 浏览器	点击「连接」,在浏览器完成 OAuth 同意

完成后用 验证连接 测试是否真的能取到数据。

准备好了就进 步骤 1 · 创建 GCP 项目。