findmy-location
Track a shared contact's location via Apple Find My with street-level accuracy. Returns address, city, and context (home/work/out) by reading map landmarks. Supports configurable known locations and vision fallback for unknown places.
Why use this skill?
Use OpenClaw to track shared Apple Find My contacts with street-level accuracy. Get location context, custom labels, and automated updates easily.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/poiley/findmy-locationWhat This Skill Does
The findmy-location skill is a powerful automation tool designed to bridge the gap between Apple's proprietary Find My ecosystem and your OpenClaw agent. By leveraging accessibility APIs and screen-reading technology, it provides near-real-time location data for your shared contacts with high precision. Unlike basic GPS trackers, this skill interprets map visual data to deliver context-aware results, telling you not just where a person is (e.g., coordinates or street names), but providing semantic labels like 'home' or 'work' based on your custom landmarks.
Installation
Installation is straightforward. First, ensure you have macOS 13+ and a properly configured iCloud account with location sharing enabled. Install the required dependencies: peekaboo via homebrew for screen analysis, and optionally Hammerspoon for reliable UI interaction. Once installed via clawdhub install findmy-location, define your target contact and custom location markers in ~/.config/findmy-location/config.json. This configuration is vital as it allows the agent to map visual map data to specific, human-readable addresses.
Use Cases
This skill is perfect for users who need to maintain situational awareness regarding family members or team assets. Use it to check if a family member has arrived home safely from school, confirm if a colleague is still at the office during a late-night project, or determine if someone is in transit versus stationary. It is particularly useful for automated reporting, where your OpenClaw agent can notify you of status changes without requiring you to manually open the Find My application.
Example Prompts
- "Check if Sarah is currently at the office or heading home."
- "Where is John right now, and what street is he on?"
- "Is the kids' location currently reporting as 'home', or are they still at school?"
Tips & Limitations
To ensure maximum reliability, always grant the required Accessibility and Screen Recording permissions to both the terminal and any helper applications like Hammerspoon. Because this skill interprets visual map data, it is sensitive to screen resolution and app window sizing; keep your Find My window open and unobstructed for best performance. Note that this skill requires an active internet connection and the target must have authorized location sharing on their device. Avoid over-polling the service to maintain your system's battery life and to avoid potential rate-limiting from the UI rendering engine.
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-poiley-findmy-location": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write, code-execution