Google Photos

📸 托管OAuth直连谷歌相册·安全上传与专辑管理

通过托管OAuth安全连接Google Photos API,支持照片上传、专辑管理与搜索,无需自行配置密钥,3步完成账号绑定。

收藏
9.3k
安装
2.1k
版本
1.0.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Google Photos skill 基于 Google Photos Library API 构建,通过 ClawLink 提供托管式 OAuth 认证,用户无需自行申请 API 密钥或处理复杂的 Google Cloud 配置。安装 ClawLink 插件后,执行三步流程(安装插件 → 设备配对 → 连接 Google Photos)即可在 OpenClaw 聊天中直接调用照片管理功能。

主要功能模块:

  • 专辑管理:列出、获取、创建、更新相册
  • 媒体项操作:搜索、批量获取、下载、更新描述
  • 上传功能:单文件上传(图片200MB/视频20GB)、批量创建(每次最多50项)
  • 专辑内容管理:向专辑添加媒体项、添加文字/位置等富文本标注

所有工具调用均通过 clawlink_call_tool 统一接口执行,ClawLink 自动注入 OAuth Token,聊天中无需处理认证细节。

显著优点

1. 零配置接入:ClawLink 托管 OAuth 流程,省去 Google Cloud Console 项目创建、OAuth 2.0 客户端配置等繁琐步骤
2. 权限隔离明确:读写操作严格分离,所有写入类操作(创建、更新、删除)强制要求用户显式确认

3. 大文件支持:视频上传支持最高 20GB,满足高清/4K 视频备份需求

4. 批量处理能力:单次请求可处理最多 50 个媒体项,适合批量归档场景

5. 实时工具发现:通过 clawlink_list_tools 动态获取可用工具列表,避免硬编码依赖

潜在缺点与局限性

关键 API 限制(截至2025年3月31日):Google Photos Library API 仅返回由该应用上传或创建的媒体项,无法访问用户通过手机相机拍摄或其他应用上传的照片。如需访问完整图库,必须改用 Google Photos Picker API。这意味着:

  • 无法搜索用户现有照片库中的历史图片
  • 上传的照片在 Google Photos 主界面中不可见(仅限 API 访问)
  • 实际应用场景大幅受限,主要适合「应用专属备份」而非「个人照片管理」

其他局限

  • 依赖 ClawLink 第三方服务,若其服务中断将影响全部功能
  • 媒体项 ID 需从创建或列表响应中捕获,无法预判
  • 专辑富文本标注功能较为冷门,学习成本较高

适合人群

  • 需要为自研应用/服务构建照片备份功能的开发者
  • 希望批量归档网络图片到云端专辑的高级用户
  • 能接受「应用隔离」存储模式、不依赖主图库访问的技术用户

不适合:期望直接管理手机中已有数千张照片的普通用户,或需要跨应用照片检索的场景。

常规风险

1. 数据可见性风险:API 上传的照片默认不在用户主 Photos UI 显示,可能导致「数据已上传但找不到」的困惑
2. 第三方信任链:OAuth Token 由 ClawLink 托管存储,需信任其安全实践(文档声称「安全存储」但未披露具体架构)

3. 权限范围较宽:连接后理论上具备读取全部媒体项元数据、创建新内容的权限,虽写入需确认,但读取操作无额外拦截

4. 服务连续性风险:Google Photos API 政策变更频繁(如此次的可见性限制),ClawLink 作为代理层可能滞后适配

Google Photos 内容

手动下载zip · 5.6 kB
skill-card.mdtext/markdown
请选择文件