---
type: library
origin: Gog.md
originPath: sources/Gog.md
ingested: 2026-05-04
updated: 2026-05-04T05:06:00Z
tags: [google-workspace, cli, gmail, calendar, drive, sheets, docs, openclaw-skill, clippings]
sourceUrl: https://clawhub.ai/steipete/gog
versionHash: k97dg6nasj52d3s3mcegcwqmx17ykzqb
---

## 摘要

Gog 是 steipete 开发的 Google Workspace CLI，覆盖 Gmail、日历、Drive、通讯录、Sheets、Docs 六大数据域。一次 OAuth 设置后可在终端完成所有操作。安装方式：`openclaw skills install gog`。

## 安装与配置

### 安装

```bash
openclaw skills install gog
```

### OAuth 设置（一次性）

首次使用会触发 OAuth 认证流程，授权 Gog 访问你的 Google 账号。完成后凭证会缓存，无需重复登录。

### 环境变量

```bash
# 避免每次传 --account 参数
export GOG_ACCOUNT=you@gmail.com
```

## 功能清单

### Gmail

| 命令 | 说明 |
|------|------|
| `gog gmail search 'newer_than:7d' --max 10` | 搜索邮件（原生 Gmail 语法） |
| `gog gmail send --to a@b.com --subject "Hi" --body "Hello"` | 发送邮件 |

**Gmail 搜索语法示例**（与网页版 Gmail 一致）：
- `from:alice subject:report newer_than:7d`
- `has:attachment larger:5M`
- `is:unread label:work`

### 日历

```bash
gog calendar events <calendarId> --from 2026-05-01 --to 2026-05-07
```

- `calendarId` 可通过 `gog calendar list` 获取
- 支持跨时区 ISO 格式时间

### Drive

```bash
gog drive search "project资料" --max 10
```

- 支持任意字符串全文搜索
- 结果包含文件 ID、名称、修改时间

### 通讯录

```bash
gog contacts list --max 20
```

### Sheets

| 命令 | 说明 |
|------|------|
| `gog sheets get <sheetId> "Tab!A1:D10" --json` | 读取范围数据 |
| `gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED` | 更新单元格 |
| `gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS` | 追加行 |
| `gog sheets clear <sheetId> "Tab!A2:Z"` | 清空区域 |
| `gog sheets metadata <sheetId> --json` | 获取工作表元数据 |

**内联传值技巧**：`--values-json` 接受标准 JSON 数组，避免构造临时文件。

### Docs

| 命令 | 说明 |
|------|------|
| `gog docs export <docId> --format txt --out /tmp/doc.txt` | 导出为纯文本 |
| `gog docs cat <docId>` | 终端内查看文档内容 |

**注意**：就地编辑需要文档 API 客户端，Gog 不包含此功能。

## 脚本化建议

```bash
# 推荐组合：JSON 输出 + 跳过交互确认
gog gmail search 'is:unread' --max 5 --json --no-input
```

- `--json`：结构化输出，便于解析
- `--no-input`：跳过所有确认提示，适合 cron 任务和管道

## 版本信息

当前版本 hash：`k97dg6nasj52d3s3mcegcwqmx17ykzqb`（每次 install 时可获取最新）

## 本文件对 wiki 的贡献

- 实体：[[wiki/entities/gog|Gog]]
- 概念：Google Workspace CLI 工具链
- 生态关联：OpenClaw Skills 在 CLI 场景的代表工具

## 相关页面

- [[wiki/entities/gog|Gog（实体）]]
- [[wiki/concepts/mcp|MCP]]
- [[wiki/concepts/openclaw-skills|OpenClaw Skills]]