gmail-label-manager

📧 Gmail智能标签自动管理专家

基于发件人历史邮件智能学习的Gmail自动化整理工具,自动分类标签并归档,让收件箱保持井然有序。

收藏
3.1k
安装
868
版本
v1.0.3
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Gmail Label Manager 是一款专为 Gmail 用户设计的自动化邮件整理工具,通过分析已归档邮件的历史标签模式,自动为未读邮件分类、应用标签并完成归档。该技能基于 Bash 脚本开发,依赖 gog CLI 工具调用 Gmail API,无需维护静态规则库,而是从用户的历史邮件行为中动态学习分类逻辑,实现智能化的收件箱管理。

核心用法方面,用户需先安装并认证 gog CLI 工具,将技能文件部署至 OpenClaw 工作区。脚本运行时,会查找收件箱中第一封未读邮件,分析来自同一发件人的已归档邮件所使用的标签(忽略仍在收件箱中的邮件标签),自动应用匹配的标签并移除不相关的系统标签(如 CATEGORY_PROMOTIONSUNREAD 等),最后通过移除 INBOX 标签完成归档。整个过程支持通过 DRY_RUN 环境变量进行干运行测试,确保操作符合预期后再实际执行。

显著优点在于其动态学习机制,无需手动配置复杂的过滤规则,系统能从用户过往的分类习惯中自主学习。脚本采用 set -euo pipefail 严格模式,具备完善的错误处理和日志记录机制,支持 Telegram 通知功能(需主动配置环境变量)。此外,代码完全开源,使用标准 Unix 工具(jq、grep、sed 等),无动态代码加载风险,安全透明可审计。

潜在局限包括依赖外部 gog CLI 工具,需要用户单独安装和 OAuth 认证;脚本中包含硬编码的家庭信息示例(如儿童姓名、学校名称等),使用前必须根据实际需求修改;作为 T3 来源的个人开发者项目,虽代码透明但缺乏企业级维护支持。此外,该工具主要针对个人邮件整理场景,不适合处理高度敏感的机密邮件或多人共享环境。

适合人群主要为 Gmail 重度用户、收件箱经常堆积大量未读邮件的职场人士,以及希望通过自动化减少邮件整理时间的效率爱好者。特别适合那些已经养成标签分类习惯,希望系统能基于历史行为自动延续这种分类逻辑的用户。

使用风险主要包括误归档风险:虽然脚本会分析历史模式,但仍可能将重要邮件错误分类或归档,建议初期使用 --dry-run 模式验证;权限风险:gog CLI 需要 Gmail 的读写权限,应在可信环境中完成 OAuth 认证;数据隐私方面,虽然脚本仅在本地处理邮件内容,但日志文件会保存在本地 logs/ 目录,需定期清理避免敏感信息积累。

安全解读

核心用法

Gmail Label Manager 是一款自动化邮件管理工具,通过分析用户历史归档邮件的标签模式,智能处理未读邮件。工作流程如下:

1. 智能识别:查找首个未读邮件,动态分析同一发件人在已归档邮件上的标签分布
2. 自动标记:将推断出的合适标签应用于未读邮件,移除无关标签(包括系统自动分类标签如 CATEGORY_PROMOTIONS 等)

3. 归档处理:移除 INBOX 标签完成归档,并验证操作结果

该技能无需静态规则配置,完全从用户已有的邮件整理习惯中学习,实现"越用越准"的个性化分类效果。

显著优点

  • 零配置智能学习:无需手动设置过滤规则,自动继承用户的归档习惯
  • 隐私优先设计:数据最小化原则,仅访问功能必需的邮件元数据
  • 模块化 Bash 架构:代码结构清晰,含完善的错误处理 (set -euo pipefail) 和日志机制
  • 外部依赖可控:仅通过 gog CLI 调用 Google API,无第三方依赖库
  • 通知集成:内置 Telegram Bot 通知,操作结果实时可追踪

潜在局限

  • 单邮件顺序处理:当前为串行处理首个未读邮件,非批量处理模式
  • Bash 环境依赖:需预装 gog CLI 并完成 OAuth 认证,Windows 原生环境支持有限
  • 标签学习边界:若某发件人无归档邮件参考,则无法推断标签,可能跳过处理
  • 无图形界面:纯命令行工具,对非技术用户门槛较高

适合人群

  • 收件箱邮件量大、需要自动化归档的资深 Gmail 用户
  • 已养成标签分类习惯、希望减少重复操作效率极客
  • 熟悉命令行工具、具备基础 Bash/CLI 使用经验的开发者或运维人员
  • 重视数据隐私、倾向本地化处理而非云端 SaaS 方案的用户

常规风险与注意事项

| 风险项 | 说明 | 缓解措施 |
|--------|------|----------|
| API 权限范围 | 需授权 Gmail 标签修改权限 | 使用 OAuth 最小权限原则,定期审查授权 |
| 误标签风险 | 学习模式可能推断错误标签 | 运行初期建议手动抽查验证 |
| Telegram 通知配置 | Token 泄露可能导致机器人滥用 | 通过环境变量注入,避免硬编码 |
| `gog` CLI 可用性 | 工具未安装或认证过期会导致失败 | 部署前验证 `gog auth` 状态 |
| 归档不可逆操作 | 移除 INBOX 标签后邮件不再主列表显示 | 确认标签正确后再启用自动模式 |

gmail-label-manager 内容

手动下载zip · 16.5 kB
script.shtext/x-shellscript
请选择文件