clawemail

ClawEmail 是一个专为 AI Agent 设计的 Google Workspace 集成技能，通过标准化的 OAuth 2.0 认证流程，为开发者提供对 Gmail、Google Drive、Docs、Sheets、Slides、Calendar 和 Forms 的全套 API 操作能力。该技能本质上是一个封装了 Google REST API 的命令行工具集，允许用户通过简单的 curl 命令和 Python 脚本实现邮件收发、文件管理、文档编辑、表格处理、演示文稿制作、日程安排以及表单收集等复杂办公自动化任务。

核心用法上，用户首先需要在 ClawEmail 官网注册并获取 OAuth 凭证，配置本地环境变量后，通过 token.sh 脚本获取临时访问令牌。基于该令牌，用户可以执行各类操作：在 Gmail 中搜索、阅读、发送邮件及管理标签；在 Drive 中进行文件的上传、下载、分享和权限管理；在 Docs/Sheets/Slides 中创建、读取、编辑内容，支持批量更新操作；在 Calendar 中管理日程事件；在 Forms 中创建问卷并获取回复数据。所有操作均通过 HTTPS 与 Google 官方 API 通信，返回 JSON 格式数据便于程序处理。

显著优点包括其全面的服务覆盖面，几乎涵盖了 Google Workspace 的所有核心功能；采用官方标准 API 而非非官方爬虫，稳定性和兼容性有保障；内置的 token 缓存机制（50 分钟有效期）减少了频繁认证的开销；支持批量操作（batchUpdate）提升效率；权限申请与功能完全匹配，遵循最小权限原则。此外，作为 T2 来源的开源项目（MIT 许可证），代码公开透明，经过社区检验。

潜在缺点主要在于配置门槛：用户必须自行注册 ClawEmail 服务并妥善管理 OAuth 凭证文件，对非技术用户不够友好；完全依赖 Google 服务的网络可用性；需要系统预装 curl 和 Python3 环境；token 的本地缓存虽然方便但增加了文件安全管理负担；此外，Google API 存在调用频率限制，高频操作可能需要额外的重试和限流处理。

该技能特别适合需要与 Google Workspace 深度集成的开发者、运维人员、自动化工作流设计者，以及希望通过 AI Agent 自动化处理邮件、文档和日程的企业用户。对于已经使用 Google Workspace 作为办公基础架构的团队，这是实现 RPA（机器人流程自动化）的理想工具。

使用风险方面，主要需注意凭证安全问题：如果 credentials.json 或缓存的 access_token 文件权限设置不当（建议 600），可能导致账号被非法访问；其次，所有数据均通过 Google 服务器处理，对数据隐私要求极高的敏感场景需谨慎评估；网络中断将导致服务完全不可用；API 调用产生的费用需用户自行承担；最后，错误的批量操作（如批量删除）可能对生产数据造成不可逆影响，建议先在测试环境验证。