用途
该技能为智能体提供 Google Workspace 集成能力，底层使用 gog CLI（gogcli）。智能体在执行所有操作时直接调用 gog 命令，覆盖 Gmail、Google Calendar、Google Drive、Google Docs、Google Sheets 和 Google Slides 六大服务。当用户要求搜索邮件、安排会议、管理文件、编辑文档表格或处理幻灯片时可以使用。
前置条件
需要先安装 gog 二进制文件。Homebrew 方式：brew install openclaw/tap/gogcli。手动方式（Linux amd64）：curl -sL https://github.com/openclaw/gogcli/releases/latest/download/gogcli_VERSION_linux_amd64.tar.gz | tar xz，然后 mv gog ~/.local/bin/。容器和 MCP 服务器替代方案参见 configuration.md。
网络访问
Google Workspace 命令需要到 Google API 和 OAuth 端点的出站 HTTPS，包括认证和令牌刷新。远程操作需要出站网络访问。如果智能体环境限制了访问，需通过该环境的审批或网络控制获得访问权限后再执行第一条远程命令，并复用已授予的授权。本地帮助和文件处理不需要网络访问。技能指令本身不授予网络权限。DNS、连接和超时故障应报告为网络错误，不要重置凭据来解决这些问题。如果获批访问后仍失败，应停止并报告。认证和权限错误需要用户操作。
认证
- 导入凭据：
gog auth credentials set /path/to/credentials.json（credentials.json 来自 Google Cloud Console） - 按需授权服务：
gog auth add your@email.com --services gmail,calendar,drive,docs,sheets,slides（会打开浏览器） - 验证：
gog auth doctor
主要能力
Gmail
搜索（gog gmail search "is:unread"）、读取消息与会话、列出标签；组织操作包括标记已读/未读、归档、移入回收站；发送、回复、转发邮件；管理草稿（列出、创建、发送）。
Google Calendar
查看日历列表、今日事件、指定时间范围事件、单个事件、空闲/忙碌查询、搜索；创建事件；更新、删除事件、回复邀请（如 --status accepted）。
Google Drive
浏览目录、按文件夹列出、搜索文件、查看目录树、获取文件信息；上传、下载、复制、移动、重命名、删除；共享（--email 与 --role）、查看权限、取消共享。
Google Docs
读取信息、内容、导出（如 --format md）、查看结构；创建文档、写入内容、在指定位置插入、查找替换、格式化（如 --bold --start --end）；插入表格与更新单元格。文中还提供文档工作流，例如从 markdown 导入并设置行距与段后间距，或从 markdown 更新现有文档（--markdown --replace --pageless）。
Google Sheets
读取元数据、指定范围数据、公式格式；创建表格、更新、追加、清空；添加、删除、重命名标签页。
Google Slides
读取信息、列出幻灯片、读取单页、导出（如 pptx）；创建演示文稿、从 markdown 创建、从模板创建（支持 --replacements 替换）；新增幻灯片、插入文本、替换文本、插入图片。
使用方式
所有命令支持 --json 结构化输出和 --plain TSV 输出，可用 --select 选择字段。示例：
搜索并汇总近期邮件：gog gmail search "is:unread newer_than:7d" --json --results-only | jq '.[] | "\(.from): \(.subject)"'
下载近期文档：gog drive search "type:document newer_than:7d" --json --results-only | jq -r '.[] | .id' | while read docId; do gog docs export "$docId" --format md > "doc_$docId.md"; done
检查会议可用时间：gog calendar freebusy --from "2026-06-25T09:00:00Z" --to "2026-06-25T17:00:00Z"
智能体安全
提供只读模式 gog --readonly（阻止所有变更操作）、禁止 Gmail 发送 gog --gmail-no-send、预览操作 gog --dry-run、禁用交互提示 gog --no-input（失败而非等待输入）。
错误处理
退出码含义：0 成功；3 空结果（正常）；4 需要认证（需运行 gog auth setup）；5 未找到；6 权限被拒；7 触发速率限制（可等待后重试）；8 可重试的服务器错误（可等待后重试）。认证和权限错误需要用户介入，速率限制和服务器错误可在短暂等待后重试。
限制
远程操作依赖出站 HTTPS 到 Google API 和 OAuth 端点，受网络策略限制时需先获得审批。认证与权限问题必须由用户处理。技能指令不授予网络权限。