Google工作流助手

技能简介

ez-google 是一套面向智能体的 Google Workspace 自动化工具集，通过托管式 OAuth 实现免 API 密钥接入。用户只需点击授权链接、粘贴返回令牌即可完成身份验证，无需手动配置凭证。

能做什么

• 邮件管理：收发邮件、搜索筛选、批量标签处理、草稿创建
• 日程安排：查看日历、创建/删除事件、管理多个日历
• 文件操作：Drive 文件搜索下载、文件夹创建、Docs/Sheets/Slides 读写编辑
• 联系人查询：搜索联系人、获取详细信息
• 团队协作：Workspace Chat 空间消息收发（需企业版）

使用说明

环境准备

# 安装依赖（项目使用 uv 包管理器）
uv pip install -e .

第一步：完成 OAuth 认证

uv run scripts/auth.py status        # 检查认证状态
uv run scripts/auth.py login         # 获取授权链接发送给用户
uv run scripts/auth.py save '<TOKEN>'  # 保存用户粘贴的令牌

第二步：执行具体任务

所有命令统一格式：uv run scripts/<脚本>.py <命令> [参数]

常用示例：

# Gmail：列出最近10封邮件
uv run scripts/gmail.py list -n 10

# 日历：创建今日会议
uv run scripts/gcal.py create "团队周会" "2024-01-15T10:00" "2024-01-15T11:00"

# 表格：读取 A1:D10 区域数据
uv run scripts/sheets.py get SPREADSHEET_ID "Sheet1!A1:D10"

# 批量归档旧邮件
uv run scripts/gmail.py bulk-label "older_than:90d" --add ARCHIVE --remove INBOX

权限更新：新增服务后需执行 auth.py logout 再重新 login 以授予新权限。

输入与输出

见下方输入与输出表格。

风险提示

• OAuth 令牌具有完整 Google 账号访问权限，需妥善保管避免泄露
• 批量操作（如 bulk-trash）默认带确认提示，生产环境使用 -y 参数前请二次核对筛选条件
• API 调用存在配额限制，高频场景建议添加重试逻辑
• Chat 功能仅限 Google Workspace 企业版账号使用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/araa47/ez-google/SKILL.md
来源类型：GitHub 开源项目