Setup & Installation
openclaw skills install @loganprit/apple-find-my-local
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install apple-find-my-local
Version History
v1.0.2Feb 16, 2026 - Version note by skill developer:
Added metadata, security fixes, and privacy docs
What This Skill Does
Controls the native macOS Find My app through UI automation via Peekaboo, allowing location lookups for people, devices, and AirTag items. Operates entirely locally with no third-party API calls or Apple ID credential exposure.
Uses native app automation instead of unofficial APIs, so no credentials leave the device and no Apple ID access is required.
When to use it
- Checking where an AirTag-tracked item is on a map
- Playing a sound on a lost wallet or keys
- Seeing a family member's current location
- Listing all tracked devices in a household
- Locating a misplaced Mac or iPhone
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: where are my keys?
AGENT
- 1Run fm-list.sh items to screenshot the Items tab
- 2Identify the position of the keys entry in the sidebar
- 3Run fm-locate.sh with that position number
- 4Capture a screenshot showing the map location
- 5Return the screenshot path with the map view
OUTPUT
Screenshot of Find My showing the AirTag location on a map
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
OpenClaw.app installed and running with Screen Recording and Accessibility permissions grantedPeekaboo CLI installed and configuredPEEKABOO_BRIDGE_SOCKET environment variable set to the OpenClaw bridge socket pathFind My.app open on macOS