- name
- google-photos
- description
- Manage Google Photos library. Upload photos, create albums, and list library content. Use when the user wants to backup, organize, or share images via Google Photos.
- metadata
- {"openclaw":{"emoji":"📸","requires":{"apis":["photoslibrary.googleapis.com"]}}}
Google Photos
This skill provides a way to interact with Google Photos Library API to automate photo management.
Setup
- Enable API: Enable the "Google Photos Library API" in your Google Cloud Console project.
- Credentials: Download your OAuth 2.0 Client ID credentials as
credentials.json. - Environment: This skill uses a Python virtual environment located in its folder.
Usage
All commands are run through the scripts/gphotos.py script.
List Albums
Useful for finding the ID of an existing album.
./scripts/gphotos.py --action list --credentials /path/to/credentials.json --token /path/to/token.pickleCreate a New Album
./scripts/gphotos.py --action create --title "Vacations 2026" --credentials /path/to/credentials.json --token /path/to/token.pickleUpload a Photo
You can optionally specify an --album-id to add the photo to a specific album.
./scripts/gphotos.py --action upload --photo "/path/to/image.jpg" --album-id "ALBUM_ID" --credentials /path/to/credentials.json --token /path/to/token.picklePrivacy & Security
- This skill only has access to photos it uploads or that are explicitly shared with the application.
- Credentials and tokens are stored locally and should be kept secure.
- Never share your
credentials.jsonortoken.picklefiles.