A specialized AI agent skill for managing Apple AirTags, locating items, and troubleshooting Find My connectivity.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install airtag
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install airtag using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is AirTag?
The AirTag skill provides your AI agent with controlled, secure access to your Apple account's tracking ecosystem. By integrating this capability into Openclaw Skills, developers and users can automate the process of locating misplaced items, performing battery health checks, and resolving setup failures. The skill operates with high privacy standards, offering multiple connection modes ranging from direct UI automation on macOS to programmatic API interactions for power users.
This skill is designed to bridge the gap between AI reasoning and physical hardware tracking. Whether you need to audit your inventory of trackers or handle critical safety alerts regarding unknown tags, the AirTag skill for Openclaw Skills ensures your agent has the right context and tools to act effectively.
AirTag Use Cases
- Locating lost or misplaced items using Find My account visibility.
- Troubleshooting and recovering from AirTag pairing or setup failures.
- Monitoring battery levels and signal reliability across multiple tracking devices.
- Managing safety workflows for unknown AirTag alerts to mitigate stalking risks.
- Automating lost-item recovery playbooks with historical incident logging.
How AirTag Works
- The agent establishes an Access Mode, choosing between Direct App Control (macOS), Programmatic API, or Shared Link Mode.
- The skill validates the selected connector to ensure a stable data path to the Find My service.
- An inventory of available AirTags is constructed, mapping technical hardware IDs to human-readable aliases.
- For location requests, the skill executes a structured workflow starting from live tracking and escalating to stale-location triage if necessary.
- Diagnostic data, maintenance history, and incident logs are persisted in local memory files for long-term reliability monitoring.
AirTag Setup
To integrate this skill into your Openclaw Skills workflow, follow these steps:
- Review the
setup.mdfile within the skill directory to select your preferred access mode. - If using Direct App Control on macOS, ensure Find My.app is signed in and local UI automation permissions are granted.
- Initialize the local storage directory for tracking data:
mkdir -p ~/airtag
- Validate your connection by running a diagnostic check to confirm account visibility.
AirTag Data Schema & Taxonomy
The skill manages tracking data and device state within the ~/airtag/ directory using a structured Markdown schema:
| File | Purpose |
|---|---|
memory.md |
Stores active connector status and operating boundaries. |
items.md |
Inventory of all AirTags, including aliases and ownership details. |
incidents.md |
Timeline of recovery actions taken for lost items and their outcomes. |
maintenance.md |
Logs battery replacement history and signal reliability notes. |
safe-zones.md |
Defines expected locations to prevent unnecessary alerts. |
AirTag Advanced Features
- Support for multiple access connectors including local UI automation and unofficial API modes.
- Deterministic recovery playbooks that separate connector authorization issues from hardware range problems.
- Integrated anti-stalking safety workflows for managing unauthorized tracker alerts.
- Local-first memory persistence ensuring sensitive location history remains on your machine.
- Synergy with other Openclaw Skills such as the ios and bluetooth modules for comprehensive device troubleshooting.
SKILL.md
Loading
Related Openclaw Skills
Artificial Intelligence
A technical skill that empowers AI agents to provide real-time, accurate data on model pricing, rankings, and hardware requirements by bypassing outdated training data.
AGI / Artificial General Intelligence
A meta-cognitive reasoning layer that transforms AI agents from simple executors into human-level planners with self-awareness.
Agentic Engineering
A tactical framework for maximizing productivity by orchestrating multiple AI coding agents through parallel workflows and pragmatic tool selection.
Agentic Coding
A professional workflow for shipping reviewer-ready production code through AI agents using strict contracts and the PACT protocol.
Alerts
A sophisticated framework for managing AI agent reliability through smart deduplication, severity-based routing, and automated incident remediation.
Alexa Skill Manager
A comprehensive framework for controlling smart home devices, designing automated routines, and building custom Alexa skills.
Featured*
