核心用法
本 Skill 通过 ClawLink 托管的 OAuth 流程,实现与 Google Drive API 的安全集成。用户完成三步安装(安装插件、配对账户、连接 Drive)后,即可在 OpenClaw 对话中调用 70+ 个工具完成文件全生命周期管理。
主要能力矩阵:
- 发现与元数据:文件/文件夹搜索、子项列举、共享盘列表、存储配额查询
- 创建与上传:空文件/文件夹创建、文本/二进制文件上传(支持 10MB 直接上传、5MB+ 断点续传)、URL 拉取上传
- 下载与导出:原文件下载、Google Workspace 格式导出(如 Sheets → CSV)
- 组织管理:文件移动、复制、添加快捷方式、父子关系调整
- 权限与共享:用户/组/域/公开分享、权限增删改查、访问申请审批
- 协作功能:评论与回复的完整 CRUD
- 共享盘管理:创建、更新、隐藏/取消隐藏、删除共享盘
- 版本与回收站:版本历史查看、永久删除、回收站清空(不可逆)
- 变更追踪:变更令牌获取、变更列表查询、Webhook 订阅
安全执行模型:
- 读操作可直接执行
- 所有写操作(创建、更新、删除、权限变更)强制要求用户显式确认
- 高影响操作(删除、清空回收站)标记为高风险,必须二次确认
显著优点
1. 零配置接入:ClawLink 托管 OAuth 令牌,用户无需创建 Google Cloud 项目或管理 API 密钥
2. 细粒度权限控制:支持用户/组/域/公开四种分享类型,角色细分至 owner/writer/commenter/reader
3. 大文件支持:断点续传(resumable upload)支持 GB 级文件上传
4. Workspace 原生集成:与 Google Docs/Sheets/Slides Skills 协同,Drive 存元数据、专用 Skills 处理内容
5. 实时变更追踪:通过 page token 机制实现增量同步,支持 Webhook 推送通知
潜在缺点与局限性
- 第三方依赖:核心认证与代理服务由 ClawLink 提供,可用性受其 SLA 约束
- 并发限制:同一文件的权限操作不支持并发,仅最后一次更新生效
- 配额盲区:
get_about仅返回 My Drive 配额,不包含共享盘存储 - Workspace 文件限制:二进制编辑工具不支持 Google Docs/Sheets/Slides 原生格式,需使用专用 Skills
- 传播延迟:权限变更后可能有短暂延迟才在查询结果中体现
适合人群
- 需要自动化 Google Drive 文件管理的知识工作者
- 团队协作场景下的权限管理员
- 构建文档工作流(上传 → 处理 → 分享 → 归档)的自动化用户
- 不愿维护 OAuth 基础设施的中小型团队
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 数据误删 | `empty_trash` 永久删除不可恢复 | 强制二次确认,执行前展示受影响文件数量 |
| 权限泄露 | 意外将敏感文件设为公开分享 | `create_permission` 需用户确认,建议先用 `preview_tool` 验证 |
| 令牌泄露 | ClawLink 托管令牌若遭入侵 | 依赖 ClawLink 安全架构,用户侧可定期在 dashboard 撤销授权 |
| API 限流 | 高频调用触发 Google Drive API 配额限制 | 遵循变更令牌模式避免全量扫描,大文件使用断点续传 |
| 供应链风险 | ClawLink 服务中断导致工具不可用 | 本地缓存关键文件元数据,制定降级方案 |