OpenAB Google Chat Bundle

一键部署的 OpenAB Google Chat bot — bot agent 与 gateway 打包在一起，粘贴 Service Account JSON、在 Google Cloud Console 设置一次 App URL 即可。

前置需求：Google Workspace 账号（Business / Enterprise 方案）。消费者 @gmail.com 账号无法创建 Google Chat App。 同时需要可在 Google Cloud Console 启用 Chat API 并创建 service account 的项目访问权。

部署内容

服务	用途	公开
openab	运行 Kiro CLI 的 OAB agent	否
openab-gateway	Google Chat 事件 → WebSocket 桥接	是（自动 HTTPS）

GOOGLE_CHAT_ENABLED=true 与 GOOGLE_CHAT_AUDIENCE（JWT 验证的 audience）由 bundle 自动设置，无需手动输入。

设置步骤

1. 启用 Google Chat API + 创建 Service Account

1. 开 Google Cloud Console → 选择或创建项目。
2. APIs & Services → Library → 搜 Google Chat API → Enable。
3. APIs & Services → Credentials → + CREATE CREDENTIALS → Service account → 填名称 → CREATE AND CONTINUE（不需赋予 role）→ DONE。
4. 点刚创建的 service account → Keys tab → ADD KEY → Create new key → JSON → Create。下载 JSON 文件。
5. 开 JSON 文件，复制全部内容，粘贴到 Service Account JSON。

2. （选填）获取 Kiro API Key

如有付费 Kiro 订阅，前往 kiro.dev → Settings → API Keys 创建 key，填入 KIRO_API_KEY。免费方案跳过此步骤。

3. 部署

点击部署。系统会自动分配公开 HTTPS 域名给 gateway 服务。

4. 通过 Device Flow 认证 Kiro（仅免费方案）

若步骤 2 已填入 KIRO_API_KEY，跳过此步骤。

待 openab 服务启动后，在 Zeabur Dashboard 打开该服务的终端，运行：

runuser -u agent -- kiro-cli login --use-device-flow

5. 于 Google Cloud Console 设置 Chat App

Google Chat App URL 必须在 GCP 手动设置——没有 API。

1. 打开 openab-gateway 服务页面 → 查自动分配的域名。
2. 完整 App URL：https://<你的_GATEWAY_域名>/webhook/googlechat
3. 回 Google Cloud Console → APIs & Services → Google Chat API → Configuration：
   • App name / Avatar URL / Description：自选。
   • Functionality：勾选 Receive 1:1 messages 与 Join spaces and group conversations。
   • Connection settings：选 App URL → 粘贴 URL → Authentication Audience 保持 HTTP Endpoint URL。
   • Visibility：限制 Workspace 域名或特定用户。
4. SAVE。

openab-gateway 服务 Instructions 区显示已自动填好的完整 App URL，可直接复制。

6. 测试

在 Google Chat（mail.google.com/chat 或独立 app）内搜 app 名称 → 开 DM → 发消息。Gateway 验证 JWT → 通过 WebSocket 转发给 OAB → OAB 通过 service account 调用 Chat REST API 回复。

Space / group chat：从 space 的 Apps & integrations 菜单邀请 app 加入。

想换不同的 agent 后端？

本 bundle 默认使用 Kiro。若想用 Claude / Codex / Cursor / Gemini / OpenCode / Hermes / Grok，请改部署对应的 bot template 搭配独立的 OpenAB Gateway。

想用其他通讯平台？

请参考 OpenAB Telegram Bundle / Feishu Bundle / LINE Bundle / WeCom Bundle / MS Teams Bundle 或独立的 OpenAB Gateway。

链接

• OpenAB GitHub
• Google Chat 设置指南