| name | photos |
| description | Find, view, and share photos from your gallery |
| version | 1.0 |
| author | MobileClaw Built-in |
| tools_required | ui, app |
Photos
Role
You help the user find, view, and share photos from their gallery using Google Photos via UI automation.
Trigger Keywords
"photo", "picture", "image", "照片", "相片", "find photo from", "show me photos of", "share a photo", "gallery"
Prerequisites
- Google Photos app must be installed
- Accessibility Service must be enabled for MobileClaw
Workflow: Browse Recent Photos
- Launch Google Photos:
app launch com.google.android.apps.photos
ui read_screen — read the photo grid showing recent photos
- Describe what's visible: dates, number of photos, any recognized faces or albums
- If user wants to view a specific photo:
ui click on it
ui read_screen — describe the full-size photo
Workflow: Search Photos
- Launch Google Photos:
app launch com.google.android.apps.photos
ui read_screen — confirm the app is open
- Tap the search bar/icon:
ui click
ui type text="<search_query>" — Google Photos supports natural queries like:
- People: "Alice", "selfies"
- Places: "Tokyo", "beach"
- Things: "food", "cat", "sunset"
- Dates: "January 2025", "last Christmas"
- Combinations: "cat photos from 2024"
ui press_key key="ENTER"
ui read_screen — read the search results grid
- Describe the results to the user and ask which one they want
Workflow: Share a Photo
- Find and open the target photo (via browse or search above)
ui read_screen — confirm the photo is displayed full-screen
- Tap the share button (share icon at the bottom):
ui click
ui read_screen — read the share sheet showing available apps
- Tap the target app (WhatsApp, LINE, email, etc.):
ui click
- Follow the target app's share flow using UI automation
Workflow: Share Multiple Photos
- In the photo grid, long-press to start selection:
ui long_press on the first photo
- Tap additional photos to select them:
ui click on each
ui read_screen — confirm selection count in the toolbar
- Tap the share button:
ui click
- Select the target app and complete the share flow
Workflow: Delete a Photo
- Open the target photo in full-screen view
- Tap the delete/trash icon:
ui click
ui read_screen — confirm the deletion dialog
- Tap "Move to trash" to confirm:
ui click
- Inform the user the photo has been trashed (recoverable for 30 days)
Tips
- Google Photos search is powerful — encourage natural language queries
- When describing photos, mention key subjects, location if visible, and approximate date
- Always confirm before deleting — this action is destructive
- For bulk operations (share, delete), confirm the count with the user before proceeding
- If the user says "find a photo of X", use search workflow. If they say "show me my recent photos", use browse workflow