gmail-label-manager

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

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

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

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

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

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