Gog Skill

Gog Skill 是什么？

Gog Skill 使用 gog 命令行工具操作 Google Workspace。它覆盖 Gmail、Google Calendar、Drive、Contacts、Sheets 和 Docs，适合搜索邮件、管理日历、读取云端文件以及自动处理表格数据。实际使用需要用户自己的 Google 账户和 OAuth 授权。

主要能力

• 搜索和发送 Gmail 邮件。
• 查询日历事件并在授权后创建相关内容。
• 搜索 Google Drive 文件和读取联系人。
• 读取、更新、追加或清空 Google Sheets 指定区域。
• 导出或读取 Google Docs 文档内容。

初次设置

用户需要准备 Google OAuth 客户端凭据，把目标账户加入 gog，并明确授权所需服务。多账户环境可以设置默认账户，也可以在命令中指定。自动化脚本应优先使用 JSON 输出和无交互模式，方便检查结果。

写入操作

发送邮件、创建日历事件、修改表格和清空区域都会改变云端数据。Skill 原始说明要求发送邮件或创建事件前进行确认。表格写入应先核对文件 ID、工作表名称和单元格范围，清空操作尤其需要谨慎。

限制与隐私

Google Docs 支持导出、读取和复制，但目录说明中不包含原位编辑。OAuth 凭据和访问令牌不应写进公开文件。授权范围应尽量缩小，并定期检查不再使用的账户连接。

许可证

ClawHub 当前版本没有声明许可证。使用或再分发前应核对作者和 gogcli 上游项目的授权说明。

常见问题 FAQ

1. Gog 是 Google 官方工具吗？

该条目是社区发布的命令行 Skill，不能仅凭名称视为 Google 官方产品。

2. 使用前必须登录吗？

需要通过 OAuth 授权自己的 Google 账户和对应服务。

3. 可以同时管理多个账户吗？

可以，但执行命令时要明确默认账户或指定目标账户。

4. 能发送邮件吗？

可以，发送前应确认收件人、主题和正文。

5. 能修改 Google Sheets 吗？

可以读取、更新、追加和清空指定区域，写入前要核对表格范围。

6. 能直接编辑 Google Docs 吗？

当前说明主要支持导出、读取和复制，原位编辑需要其他 Docs API 客户端。

7. 适合自动化脚本吗？

适合，原始说明建议使用 JSON 输出和无交互参数。

8. 怎样保护账户安全？

使用最小授权范围，妥善保存 OAuth 文件，并在高影响写入前要求确认。

来源与核验说明

本条目根据 ClawHub 上 steipete 发布的 Gog 1.0.0 内容整理，发布前已核对账户要求和写入风险。