用途:让用户的 AI 智能体获得其 Google 账号访问能力,经由 gog CLI 读取和操作 Gmail、日历、Drive、Docs、Sheets、Slides、联系人与 Tasks,供后续会话直接使用。
主要能力:
- 全程自动完成 Google 授权配置:在 Chrome AI 中打开 Google Cloud 控制台,查找或新建名为 gog CLI 的项目,启用 Gmail、Calendar、Drive、Docs、Sheets、Slides、People、Tasks 相关 API。
- 配置登录同意屏幕(应用名 gog CLI、外部受众、支持邮箱等),并在状态为 Testing 时发布应用,使访问权限长期有效;资料说明 Testing 状态的应用每 7 天会失去访问权限,发布后个人应用不会被 Google 审核,只在登录时显示警告。
- 创建 Desktop app 类型的客户端密钥,由浏览器脚本读取 client ID 与 secret 并直接写入 gog-client.json(日志只记录 saved 状态),再用 gog auth credentials set 导入并删除临时文件。
- 通过 scripts/gog-oauth.sh 在后台发起授权,打开 Google 登录页并等待最长 10 分钟;完成后输出 connected=<邮箱> services=...。退出码 4 表示用户未及时允许,可询问后重试。
- 用真实读取验证:gog gmail search 与 gog calendar events 均须无报错返回。
- 安装 gog 自带技能(npx skills add openclaw/gogcli -g -a claude-code -s gog -y),并向 shell 配置文件写入一次 GOG_ACCOUNT 环境变量,便于免 --account 使用;若存在 AGENTS.md 大脑目录,追加一行约定 Google 访问走 gog、先读后写、发邮件或改日历前先询问。
- 支持多账号:对第二个邮箱重复授权步骤即可,用 --account 切换。
使用方式:技能从链接获取时,只下载 scripts/gog-oauth.sh(curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/connect-google/scripts/gog-oauth.sh -o <scratch>/gog-oauth.sh),需要其他技能时再按名称从对应 SKILL.md 读取,不安装仓库中的其他内容。先检查 chrome-ai start、dev-browser --help、gog auth setup --help 与 jq --version;gog 缺失或过旧时,macOS 用 brew trust --formula openclaw/tap/gogcli && brew install openclaw/tap/gogcli(若存在 steipete/tap 的旧版先 brew uninstall gogcli,已保存的账号保留),Linux 从 https://github.com/openclaw/gogcli/releases 下载对应 linux_<arch> 归档并用 checksums.txt 校验后放到 ~/.local/bin。随后确定账号(参数或 Chrome AI 当前登录的 Google 账号),若 gog 已列该邮箱则跳到验证步骤。与用户沟通使用其语言、简短无术语,只描述为“Google 访问”和“密钥”。
适用场景:希望智能体代读邮件、查看日程、检索云端文档与表格的用户;需要一次配置、多会话复用的个人使用场景;需要为多个 Google 账号分别授权的场景。
限制与注意事项:仅提供 macOS 与 Linux 安装方式,资料未提及 Windows 支持;依赖 Chrome AI、dev-browser 与 jq 等前置工具;需用户亲自在 Google 页面选择账号并点击允许,macOS 首次可能需在钥匙串弹窗点“Always Allow”;client secret 只显示一次,对话框关闭后需重新创建密钥;勾选 Google 条款与发布应用前必须征得用户同意;不得打印、记录或复述密钥、登录码或钥匙串内容。是否需要付费、具体价格及更多平台支持,资料暂未提供。