find-my
Control Apple Find My app via Peekaboo to locate people, devices, and items (AirTags). Use when asked to find keys, wallet, AirTags, locate family members and friends, play sound on lost items, or check device locations. Native app control - no third-party APIs or credential sharing required.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/loganprit/apple-find-my-localFind My
Control the native Find My app via Peekaboo. No sketchy APIs or credential sharing.
Run scripts from: cd {skillDir}
Requirements
| Requirement | Details |
|---|---|
| OS | macOS only |
| Apps | Find My.app (must be open), OpenClaw.app (provides Peekaboo bridge) |
| Permissions | OpenClaw.app needs Screen Recording + Accessibility permissions |
| Peekaboo | CLI must be installed and configured |
Privacy & Security
What this skill accesses:
- Location data for people, devices, and items in your Find My app
- Screenshots of the Find My window (stored locally in
/tmp/)
What this skill does NOT do:
- No network requests to third-party services
- No credential storage or Apple ID access
- No data exfiltration — all operations are local UI automation
Data scope: The skill can see/interact with anything visible in your Find My app, including:
- Shared locations of family/friends
- Device locations (yours and Family Sharing members)
- AirTag/item locations
User awareness: This skill uses mouse clicks and UI automation. You will see the actions happening on screen.
Known Limitations
--app "Find My"hangs in Peekaboo - use--window-idinstead- Sidebar items not accessible - Find My doesn't expose item names via accessibility APIs
- Position-based selection - Select items by position (1st, 2nd, 3rd...) not by name
- macOS only - Requires Peekaboo + OpenClaw.app bridge
- Exclusive control - User cannot interact with the Mac while skill is running (mouse/clicks conflict)
Quick Reference
| Script | Purpose |
|---|---|
fm-window.sh | Get window ID and bounds (JSON) |
fm-screenshot.sh [path] | Capture Find My window |
fm-tab.sh <tab> | Switch tab: people, devices, items |
fm-list.sh [tab] | Screenshot + show sidebar positions |
fm-select-item.sh <pos> [tab] | Select item by position (1, 2, 3...) |
fm-locate.sh <pos> [tab] | Select item and screenshot location |
fm-info.sh [path] | Open info panel, screenshot |
fm-play-sound.sh <pos> | Attempt to play sound on item |
fm-click.sh <x> <y> | Click at relative window coords |
Workflow Examples
List available items
./scripts/fm-list.sh items
# Screenshots the Items tab - view image to see your AirTags/items
Find your keys (if keys are 2nd item in list)
./scripts/fm-locate.sh 2 items
# Shows location on map, outputs screenshot path
Play sound on keys
./scripts/fm-play-sound.sh 2
# Selects 2nd item, attempts to click Play Sound
# May require manual click if button not found
Check on a family member
./scripts/fm-list.sh people
# View screenshot to see who's listed
./scripts/fm-locate.sh 1 people
# Shows first person's location
UI Layout Reference
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-loganprit-apple-find-my-local": {
"enabled": true,
"auto_update": true
}
}
}