ClawEmail谷歌办公

技能简介

ClawEmail技能让AI助手通过统一的OAuth服务接入Google Workspace全套能力，包括Gmail邮件收发、Drive文件管理、Docs/Sheets/Slides文档协作以及Calendar日程安排。用户无需自行申请Google Cloud项目，通过clawemail.com即可快速获取API凭证。

业务背景

让企业员工用自然语言直接操控Google Workspace全套办公工具，无需学习复杂API或申请云项目。通过统一OAuth服务快速开通，实现邮件处理、文档协作、日程管理的智能化操作，降低办公软件使用门槛，提升日常行政与协作效率。

落地案例：市场专员策划活动时，可直接指令"查收上周来自市场部的Gmail邮件"获取历史沟通，再要求"创建下周三下午2点的Calendar会议并邀请设计组"同步日程，随后"在Drive新建活动预算Sheets并分享给财务审批"，全程对话式完成，无需切换多个应用界面。

能做什么

• 搜索、阅读、发送和回复Gmail邮件，支持HTML格式与附件处理
• 列出、搜索、上传和管理Google Drive中的文件与文件夹
• 创建和编辑Google Docs文档、Sheets表格、Slides演示文稿
• 查询和创建Calendar日历事件
• 管理Gmail标签分类与邮件归档

使用说明

第一步：获取凭证

1. 访问 https://clawemail.com 注册账号
2. 进入 /connect/YOUR_PREFIX 页面完成Google OAuth授权
3. 下载credentials.json凭证文件

第二步：安装配置

# 创建配置目录
mkdir -p ~/.config/clawemail

# 放置凭证文件
cp credentials.json ~/.config/clawemail/credentials.json

# 设置环境变量
export CLAWEMAIL_CREDENTIALS=~/.config/clawemail/credentials.json

第三步：获取访问令牌

所有API调用需携带Bearer Token，使用内置脚本自动刷新缓存：

TOKEN=$(~/.openclaw/skills/clawemail/scripts/token.sh)

令牌缓存50分钟，每次调用前赋值给TOKEN变量即可。

第四步：调用示例（Gmail搜索）

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://gmail.googleapis.com/gmail/v1/users/me/messages?q=newer_than:7d&maxResults=10" | python3 -m json.tool

输入与输出

见下方输入与输出表格。

风险提示

• 凭证文件包含敏感OAuth信息，需设置600权限并避免提交到代码仓库
• token.sh脚本生成的访问令牌有效期有限，长期任务需考虑刷新机制
• Google API存在每日配额限制，高频调用可能触发限流
• 邮件发送操作不可逆，建议先验证收件人地址
• Drive文件删除后进入回收站，彻底清空需额外调用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/cto1/clawemail/SKILL.md
来源类型：GitHub开源技能