核心用法
ClawEmail是一个专为AI Agent设计的Google Workspace代理服务，通过单一OAuth凭证封装完整的Google API调用能力。用户需在clawemail.com注册账号，获取credentials.json并配置环境变量CLAWEMAIL_CREDENTIALS，之后通过辅助脚本token.sh获取50分钟有效期的Bearer Token即可调用所有API。
该技能采用curl命令行方式与Google原生API交互，所有操作（邮件收发、文档创建编辑、表格读写、幻灯片制作、日历管理、表单处理、云端硬盘文件操作）均通过标准REST端点完成。特殊之处在于提供了Python内联脚本辅助解析Base64编码的邮件内容、提取文档纯文本等常见操作，降低了命令行处理JSON的复杂度。
显著优点
一站式集成：单一套凭证覆盖Gmail到Forms全部服务，避免了为每个Google服务单独申请API密钥和OAuth授权的繁琐流程。
Agent原生设计：针对AI Agent的自动化场景优化，token自动缓存刷新、curl命令标准化、Python辅助解析脚本，均考虑到了无浏览器环境的非交互式执行需求。
完整功能覆盖：不仅支持基础的CRUD操作，还包含邮件回复（含In-Reply-To头维护）、文档批量更新（batchUpdate）、表格公式写入（USER_ENTERED模式）、幻灯片布局选择、日历重复事件展开等进阶能力。
潜在缺点与局限性
依赖第三方代理：所有流量经由clawemail.com中转，非直连Google API，存在服务可用性依赖和潜在的数据观察风险。
凭证集中管理风险：单一JSON凭证文件即控制完整Workspace权限，泄露后果严重；且需存储于本地文件系统，与容器化/无服务器架构的密钥管理最佳实践存在冲突。
无内置错误恢复：脚本仅提供基础token刷新，对Google API的配额限制（rate limit）、偶发5xx错误、部分成功/部分失败的批量操作等复杂场景未提供重试或事务机制。
输出格式简陋：依赖命令行curl和python -c处理响应，缺乏结构化SDK，复杂业务逻辑（如递归遍历Drive文件夹、大规模表格数据同步）需自行编写大量解析代码。
适合人群
- 需要快速原型验证Google Workspace自动化能力的开发者
- 在可信环境中运行的AI Agent（如本地Claude Code、私有服务器）
- 对Google API已有一定了解、能够阅读REST文档调试问题的技术用户
- 不想处理OAuth 2.0完整流程、希望简化凭证管理的场景
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 供应链风险 | clawemail.com服务若停止运营或遭受入侵，将导致凭证失效或泄露 | 定期备份credentials，关注服务状态公告 |
| 权限过度授权 | OAuth范围涵盖全部Workspace服务，实际可能只需子集 | 按最小权限原则评估，未来关注Claw是否支持范围限制 |
| 凭证泄露 | 本地json文件被误提交至代码库或日志泄露 | 使用gitignore，配置专用目录权限，考虑secret管理工具注入 |
| API滥用封号 | Google对异常流量有自动检测，自动化脚本可能触发 | 增加请求间隔，监控429/403响应，实现指数退避 |
| 数据驻留合规 | 代理服务器可能位于特定司法管辖区 | 敏感数据场景需确认ClawEmail的架构和合规认证 |