SkillsScout
INTEGRATION-WORKFLOW ／ 集成与工作流自动化

gmail-openai-plugins

收录日期 2026-07-18·来源仓库 ↗·2026-07-22 修订
受欢迎程度
9
可用程度与相关性
8
安全性
7
8SCOUT SCORE

一、基本信息

项目 内容
名称 gmail-openai-plugins
项目自述名称 Gmail（插件清单 interface.displayName 字段，未使用中文意译名）
作者/维护者 OpenAI
来源链接 https://github.com/openai/plugins/tree/main/plugins/gmail
许可证 MIT（插件清单 plugin.json 内声明；仓库根目录未见独立 LICENSE 文件，来自 GitHub 结构化数据）
GitHub Stars 4,590（来自 GitHub API，仓库级，为 openai/plugins 整体 160+ 插件共享，非本子技能独立热度，详见第六章说明）
Forks 581（来自 GitHub API，仓库级）
最新版本 0.1.3（plugin.json 声明版本号；该子目录最近一次提交为 2026-06-17，来自提交历史）
安装方式 Codex CLI 输入 /plugins一条命令安装，或 ChatGPT 桌面版/网页版（Work mode）插件目录内安装

二、功能介绍与亮点

gmail 是 OpenAI 官方为 Codex/ChatGPT 打造的 Gmail 连接器技能，由两个协同子技能组成：gmail（收件箱分诊、线程摘要、动作提取、回复起草、邮件转发的核心能力）与 gmail-inbox-triage（把收件箱按“紧急/需尽快回复/等待中/仅供知悉”四类分诊）。技能内附 6 篇工作流参考文档（搜索策略、粘贴链接识别、打标签操作、自送达请求、回复起草、转发工作流）与一份独立的 evals.json 评测套件。

核心亮点：①OpenAI 官方出品，被官方文档收录为“Manage your inbox”标准用例；②文档颗粒度高——针对搜索语法、标签系统、回复语气匹配等场景均有专门参考文档，并附自带评测集，工程严谨度在同类连接器插件中少见；③内置明确的“Write Safety”章节，要求发送/归档/删除/打标签等写操作必须获得用户明确意图确认，官方文档也确认默认仅生成可复核的草稿，不会自动发送。

三、适用场景

固定分类：集成与工作流自动化。适用于：在 Codex 中日常处理个人或团队 Gmail 收件箱的初中级开发者与知识工作者，需要邮件分诊、摘要、回复起草与归档整理时使用；也适合把邮件处理纳入 Codex 定时自动化任务（如每日收件箱简报）的场景。

四、跨 Agent 兼容性

五、推荐理由

Gmail 是全球认知度最高的邮件产品之一，把它接入 Codex 后能直接把“收件箱分诊、线程摘要、回复起草、归档整理”这类高频重复劳动交给 Agent 处理。这个技能出自 OpenAI 官方团队，文档完整度（6 篇工作流参考 + 独立评测套件）在集成类技能中少见，且默认只生成可复核草稿、写操作需用户明确确认，安全设计意识清晰，能直接帮 Codex 用户把邮件处理这一日常刚需自动化。

六、评分

维度 分数 说明
受欢迎程度 9 OpenAI 官方出品，并被收录进官方“Manage your inbox”标准用例文档；Gmail 作为被连接产品自身具备数十亿级全球用户认知度；仓库整体 4,590 星、581 fork 为 160+ 插件合集共享，不代表本技能自身热度，故评分依据为官方权威与产品级认知度而非仓库星标
可用性 8 Codex CLI 一条 /plugins 命令即可安装；2 个协同子技能 + 6 篇工作流参考文档 + 独立 evals 套件，文档完整度在同类连接器插件中少见；最近一次提交为 2026-06-17，一个月内有更新，维护活跃；但需额外完成 Gmail 账号 OAuth 连接（非复制即用），且官方仓库有 issue（openai/codex#20710）记录“显示已安装但连接状态异常、工具不可见”的已知体验问题，故未给满分
安全性 7 见下方检查清单
综合 8.0 三项均值

安全检查清单：

  1. Shell 命令与权限范围——不涉及 shell 命令执行；通过 OpenAI 托管的 Gmail connector 以用户已登录账户名义读写邮件，权限范围由该 connector 的 OAuth 授权决定
  2. 联网外发——邮件数据经由 OpenAI/Google 官方基础设施流转，外发目标透明
  3. 凭据——不要求用户单独提供或存储 API key；复用用户在 ChatGPT/Codex 内已完成的 Gmail OAuth 连接，凭据由 OpenAI 侧 connector 托管
  4. 可疑指令——未发现；抓取到的 gmail、gmail-inbox-triage 两份 SKILL.md 全文均为规范化邮件处理指引，含专门的“Write Safety”章节要求写操作需用户明确意图确认，无越权或注入迹象
  5. 作者信誉——OpenAI 官方，Codex 产品团队直接维护，信誉最高档
  6. License——plugin.json 明确声明 MIT，但仓库根目录未检测到独立 LICENSE 文件
  7. 维护时间——2026-06-17 有提交，一个月内，无弃置风险；但截至抓取时官方仓库存在一条未关闭的 issue（openai/codex#23995），反映当前 connector 权限模型是“全有全无”式 OAuth、无法单独申请只读范围，写操作的安全边界目前依赖 skill 自身的 prompt 约束而非平台强制隔离——这是本项未给 8 分以上的主因

七、跟同类 Skills 相比的优势

Skill 定位 与本技能的差异
slack-openai-plugins 同一插件目录下的 Slack 连接器，处理即时消息与频道 面向实时协作消息场景，而非异步邮件线程；不涉及邮件线程摘要与回复起草
google-drive（openai/plugins） 同一插件目录下的 Google Drive/Docs/Sheets/Slides 连接器 聚焦文件与文档协作，不处理邮件收发与收件箱分诊
atlassian-rovo（openai/plugins） Atlassian 官方 Jira/Confluence 连接器，管理工单与知识库 面向项目管理与知识库场景，无邮件相关能力
claude-code-notion-plugin Notion 官方插件，聚焦规划、研究、会议与知识沉淀 面向 Claude Code 生态而非 Codex，以文档知识管理为核心，非邮件处理

核心差异化：同一合集内的连接器插件各自绑定不同办公应用（消息/文档/工单/知识库），本技能是其中唯一专注邮件收件箱全流程（分诊→摘要→起草→归档）的一支，且文档与评测套件完整度突出。

八、用户评价

  1. GitHub 用户（openai/codex issue #20710）：反馈插件在桌面端会出现“显示已安装勾选，但所需的 Gmail 账号连接实际返回未连接状态、且不暴露任何工具”的假阳性体验。来源：https://github.com/openai/codex/issues/20710
  2. GitHub 用户（openai/codex issue #23995）：指出当前 Gmail/Calendar connector 的读写权限是全有全无模式，写道“仅依赖 agent 行为自觉不使用写工具，不是足够强的信任边界”，并据此提出增加只读连接模式的需求。来源：https://github.com/openai/codex/issues/23995

九、其他补充

该技能自带独立的 evals.json 评测套件，用于验证分诊、摘要等行为的输出质量，这在集成类连接器插件中较为少见。官方文档建议配合 Slack、Google Drive 等其他已连接工具补充邮件缺失的背景信息，并支持通过 Codex 定时任务功能实现“每日收件箱简报”式的自动化。

十、安装使用方式

十一、注意事项