核心用法
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 作为代理层可能滞后适配