google-photos

What This Skill Does

The google-photos skill provides a robust interface for interacting with the Google Photos Library API. It enables users to automate essential photo management tasks directly from the command line or via the OpenClaw agent. The skill supports listing existing albums, creating new collections, and uploading image files from local storage to specific albums or the main library. By utilizing OAuth 2.0 authentication, it ensures that your interactions with your cloud photo library are secure and controlled.

Installation

To integrate this skill, ensure you have the OpenClaw environment set up. Run the following command: clawhub install openclaw/skills/skills/jorgermp/google-photos. Once installed, you must enable the Google Photos Library API within your Google Cloud Console project and generate OAuth 2.0 client credentials. Save these credentials as credentials.json within the skill directory. Upon the first run, the system will prompt you to authenticate, resulting in the creation of a token.pickle file which manages your session securely.

Use Cases

This skill is perfect for users who want to automate their digital workflow. Common scenarios include:

• Automatically backing up local photo exports from design tools directly to cloud albums.
• Organizing large batches of photos by creating themed albums programmatically.
• Integrating photo uploads into automated scripts to sync media libraries across devices.

Example Prompts

1. "OpenClaw, list all my current Google Photos albums so I can find the one named 'Summer 2024'."
2. "Create a new album called 'Project Assets' in my Google Photos library."
3. "Upload the file 'screenshot.png' from my downloads folder to the 'Project Assets' album."

Tips & Limitations

• Security: Never commit your credentials.json or token.pickle to version control, as these grant full access to your photo library.
• Rate Limits: Be mindful of Google API quota limits for upload frequency.
• File Support: Ensure image files are in supported formats (JPEG, PNG, HEIC) to avoid upload failures. Always keep your local environment variables updated if you move the location of your credential files.