Google Workspace Skill

Gmail、Calendar、Drive、Contacts、Sheets 和 Docs 与 Hermes 的集成。使用 OAuth2 并支持自动刷新 token（令牌）。优先使用 Google Workspace CLI（gws）（如已安装）以获得更广泛的覆盖，否则回退到 Google 的 Python 客户端库。

Skill 路径： skills/productivity/google-workspace/

配置

配置流程完全由 Agent 驱动——让 Hermes 设置 Google Workspace，它会引导你完成每个步骤。流程如下：

创建 Google Cloud 项目并启用所需 API（Gmail、Calendar、Drive、Sheets、Docs、People）

创建 OAuth 2.0 凭据（Desktop app 类型）并下载客户端密钥 JSON

授权——Hermes 生成授权 URL，你在浏览器中批准，然后将重定向 URL 粘贴回来

完成——token 从此自动刷新

仅需邮件的用户

如果你只需要邮件功能（无需 Calendar/Drive/Sheets），请改用 himalaya skill——它使用 Gmail 应用专用密码，只需 2 分钟即可完成配置，无需 Google Cloud 项目。

Gmail

搜索

返回 JSON，每条消息包含 id、from、subject、date、snippet 和 labels 字段。

读取

以文本形式返回完整消息正文（优先纯文本，回退到 HTML）。

发送

自定义 From 头

--from 标志允许你自定义外发邮件的发件人显示名称。当多个 Agent 共享同一个 Gmail 账户但希望收件人看到不同名称时，此功能非常有用：

工作原理： --from 的值会被设置为 MIME 消息的 RFC 5322 From 头。Gmail 允许在已认证的邮箱地址上自定义显示名称，无需任何额外配置。收件人看到的是自定义显示名称（如"Research Agent"），而邮箱地址保持不变。

重要提示： 如果你在 --from 中使用不同的邮箱地址（非已认证账户），Gmail 要求该地址在 Gmail 设置 → 账户 → 以其他地址发送邮件中配置为 Send As 别名。

--from 标志同时适用于 send 和 reply：

自动将回复归入同一会话（设置 In-Reply-To 和 References 头），并使用原始消息的 thread ID。

Calendar

警告

Calendar 时间必须包含时区偏移（如 -07:00）或使用 UTC（Z）。不带时区的裸日期时间（如 2026-03-01T10:00:00）存在歧义，将被视为 UTC 处理。

Drive

Sheets

Docs

返回文档标题和完整文本内容。

Contacts

输出格式

所有命令均返回 JSON。各服务的关键字段：

命令	字段
`gmail search`	`id`、`threadId`、`from`、`to`、`subject`、`date`、`snippet`、`labels`
`gmail get`	`id`、`threadId`、`from`、`to`、`subject`、`date`、`labels`、`body`
`gmail send/reply`	`status`、`id`、`threadId`
`calendar list`	`id`、`summary`、`start`、`end`、`location`、`description`、`htmlLink`
`calendar create`	`status`、`id`、`summary`、`htmlLink`
`drive search`	`id`、`name`、`mimeType`、`modifiedTime`、`webViewLink`
`contacts list`	`name`、`emails`、`phones`
`sheets get`	单元格值的二维数组

故障排查

问题	解决方法
`NOT_AUTHENTICATED`	运行配置（让 Hermes 设置 Google Workspace）
`REFRESH_FAILED`	Token 已被撤销——重新执行授权步骤
`HttpError 403: Insufficient Permission`	缺少 scope（权限范围）——撤销并以正确的服务重新授权
`HttpError 403: Access Not Configured`	API 未在 Google Cloud Console 中启用
`ModuleNotFoundError`	使用 `--install-deps` 运行配置脚本

"Google Workspace — Gmail、Calendar、Drive、Sheets 与 Docs"

Google Workspace Skill

配置

Gmail

搜索

读取

发送

自定义 From 头

回复

标签

Calendar

Drive

Sheets

Docs

Contacts

输出格式

故障排查

"Google Workspace — Gmail、Calendar、Drive、Sheets 与 Docs"

Google Workspace Skill#

配置#

Gmail#

搜索#

读取#

发送#

自定义 From 头#

回复#

标签#

Calendar#

Drive#

Sheets#

Docs#

Contacts#

输出格式#

故障排查#

Google Workspace Skill

配置

Gmail

搜索

读取

发送

自定义 From 头

回复

标签

Calendar

Drive

Sheets

Docs

Contacts

输出格式

故障排查