名称： google-photos
描述： 管理 Google 相册库。上传照片、创建相册、列出库内容。当用户希望通过 Google 相册备份、整理或分享图片时使用。
元数据： {"openclaw":{"emoji":"📸","requires":{"apis":["photoslibrary.googleapis.com"]}}}

Google 相册

此技能提供与 Google 相册库 API 交互的方式，以实现照片管理的自动化。

设置

1. 启用 API：在您的 Google Cloud Console 项目中启用 "Google Photos Library API"。
2. 凭据：将您的 OAuth 2.0 客户端 ID 凭据下载为 credentials.json 文件。
3. 环境：此技能使用其文件夹内的 Python 虚拟环境。

使用方法

所有命令均通过 scripts/gphotos.py 脚本运行。

列出相册

用于查找现有相册的 ID。

./scripts/gphotos.py --action list --credentials /path/to/credentials.json --token /path/to/token.pickle

创建新相册

./scripts/gphotos.py --action create --title "2026年假期" --credentials /path/to/credentials.json --token /path/to/token.pickle

上传照片

您可以选择性地指定 --album-id 参数，将照片添加到特定相册。

./scripts/gphotos.py --action upload --photo "/path/to/image.jpg" --album-id "ALBUM_ID" --credentials /path/to/credentials.json --token /path/to/token.pickle

隐私与安全

• 此技能仅能访问其上传的照片或明确分享给该应用程序的照片。
• 凭据和令牌存储在本地，应妥善保管。
• 切勿分享您的 credentials.json 或 token.pickle 文件。