{ "schemaVersion": "1.0", "item": { "slug": "airtag", "name": "AirTag", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/ivangdavila/airtag", "canonicalUrl": "https://clawhub.ai/ivangdavila/airtag", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/airtag", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=airtag", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "access-connectors.md", "anti-stalking-safety.md", "battery-maintenance.md", "connection-diagnostics.md", "memory-template.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/airtag" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/airtag", "agentPageUrl": "https://openagent3.xyz/skills/airtag/agent", "manifestUrl": "https://openagent3.xyz/skills/airtag/agent.json", "briefUrl": "https://openagent3.xyz/skills/airtag/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Setup", "body": "On first use, read setup.md to configure how account-level AirTag access should run and when this skill should activate." }, { "title": "When to Use", "body": "Use this skill when the user wants the agent to access any AirTag in their Apple account, locate an item, troubleshoot Find My reliability, handle unknown-AirTag alerts, or recover pairing/setup issues.\nPrefer this skill over generic Bluetooth guidance when the outcome depends on Find My account visibility." }, { "title": "Access Modes", "body": "This skill supports three access modes. Pick one before running location or diagnostics workflows:\n\nDirect App Control (recommended on macOS): Agent drives Find My.app using local UI automation.\nProgrammatic API Mode: Agent uses a user-managed connector based on the unofficial findmy ecosystem.\nShared Link Mode: User shares one item via Apple link for temporary external access.\n\nSee access-connectors.md for setup details and trade-offs." }, { "title": "Architecture", "body": "Memory lives in ~/airtag/. See memory-template.md for structure and status fields.\n\n~/airtag/\n|-- memory.md # Status, active connector mode, and operating boundaries\n|-- items.md # AirTag inventory, aliases, and ownership context\n|-- incidents.md # Lost-item timelines, actions taken, and outcomes\n|-- maintenance.md # Battery replacement history and signal reliability notes\n`-- safe-zones.md # Frequent locations and expected left-behind behavior" }, { "title": "Quick Reference", "body": "Use the smallest relevant file for the incident to keep responses fast and deterministic.\n\nTopicFileSetup flowsetup.mdMemory templatememory-template.mdConnector systems and CLI setupaccess-connectors.mdAccount-level location recovery flowrecovery-playbook.mdConnection and pairing diagnosticsconnection-diagnostics.mdBattery and signal reliabilitybattery-maintenance.mdUnknown AirTag safety workflowanti-stalking-safety.md" }, { "title": "1. Establish Access Mode Before Action", "body": "Confirm whether the user wants Direct App Control, Programmatic API Mode, or Shared Link Mode.\nDo not claim account-level access until one connector is validated and usable." }, { "title": "2. Use the Least-Exposure Connector That Solves the Task", "body": "Prefer local app control when the user has macOS and Find My already signed in.\nUse API mode only when the user has already configured the connector and explicitly accepts the trust trade-off." }, { "title": "3. Build an Inventory Before Running Recovery", "body": "Start by enumerating available tags and mapping human aliases to actual items.\nKeep inventory stable during an incident so actions target the correct AirTag." }, { "title": "4. Run Locate Workflows in Escalation Order", "body": "Start with live locate actions, then stale-location triage, then unknown-location recovery.\nEscalate only after lower-impact steps fail with evidence." }, { "title": "5. Keep Diagnostics and Pairing Deterministic", "body": "Separate connector problems (auth/session/permissions) from AirTag problems (battery, range, pairing).\nUse one controlled change at a time and record the result before the next step." }, { "title": "6. Treat Unknown AirTag Alerts as Safety-Critical", "body": "Prioritize personal safety and risk reduction before technical detail.\nUse anti-stalking-safety.md and avoid speculative attribution." }, { "title": "7. Ask Before Persisting Logs or Sensitive Context", "body": "Ask for explicit confirmation before any connector action, location pull, or local write in ~/airtag/.\nNever request Apple ID password sharing or guide key extraction inside this skill." }, { "title": "Common Traps", "body": "Claiming there is an official public AirTag account API -> false expectation and setup failures.\nSkipping connector validation before locate commands -> no data path and confusing outputs.\nRunning pairing resets before checking account/session health -> unnecessary reconfiguration.\nTreating stale map location as live tracking -> wrong recovery decisions.\nRunning connector actions without explicit user confirmation -> avoidable trust and privacy issues.\nMixing unknown-AirTag safety with normal lost-item flow -> delayed risk mitigation." }, { "title": "External Endpoints", "body": "EndpointData SentPurposehttps://www.icloud.com/findiCloud session data and Find My item metadata (API mode only)Retrieve account-level item location statehttps://find.apple.comShared item location data from user-created linkTemporary access to one lost item for recovery support\n\nNo other data is sent externally." }, { "title": "Security & Privacy", "body": "Data that leaves your machine:\n\nApple account session traffic to Find My services when a connector is active.\nOptional shared-link data when using Shared Link Mode.\n\nData that stays local:\n\nUser-approved incident notes and connector context under ~/airtag/.\n\nThis skill does NOT:\n\nUse undeclared endpoints.\nAsk for raw Apple ID passwords by default.\nStore logs outside ~/airtag/ for this skill.\nModify its own SKILL.md." }, { "title": "Trust", "body": "Programmatic API Mode depends on third-party tooling for Apple private protocols.\nOnly use that mode if the user explicitly accepts the trust and account-risk trade-offs." }, { "title": "Related Skills", "body": "Install with clawhub install if user confirms:\n\nios - iOS behavior, permissions, and system troubleshooting\nbluetooth - Bluetooth discovery and connectivity stability workflows\nhomepod - Apple ecosystem troubleshooting patterns for shared environments\ntravel - Lost-item prevention and movement planning during trips\nsiri - Voice command reliability for Apple device interactions" }, { "title": "Feedback", "body": "If useful: clawhub star airtag\nStay updated: clawhub sync" } ], "body": "Setup\n\nOn first use, read setup.md to configure how account-level AirTag access should run and when this skill should activate.\n\nWhen to Use\n\nUse this skill when the user wants the agent to access any AirTag in their Apple account, locate an item, troubleshoot Find My reliability, handle unknown-AirTag alerts, or recover pairing/setup issues. Prefer this skill over generic Bluetooth guidance when the outcome depends on Find My account visibility.\n\nAccess Modes\n\nThis skill supports three access modes. Pick one before running location or diagnostics workflows:\n\nDirect App Control (recommended on macOS): Agent drives Find My.app using local UI automation.\nProgrammatic API Mode: Agent uses a user-managed connector based on the unofficial findmy ecosystem.\nShared Link Mode: User shares one item via Apple link for temporary external access.\n\nSee access-connectors.md for setup details and trade-offs.\n\nArchitecture\n\nMemory lives in ~/airtag/. See memory-template.md for structure and status fields.\n\n~/airtag/\n|-- memory.md # Status, active connector mode, and operating boundaries\n|-- items.md # AirTag inventory, aliases, and ownership context\n|-- incidents.md # Lost-item timelines, actions taken, and outcomes\n|-- maintenance.md # Battery replacement history and signal reliability notes\n`-- safe-zones.md # Frequent locations and expected left-behind behavior\n\nQuick Reference\n\nUse the smallest relevant file for the incident to keep responses fast and deterministic.\n\nTopic\tFile\nSetup flow\tsetup.md\nMemory template\tmemory-template.md\nConnector systems and CLI setup\taccess-connectors.md\nAccount-level location recovery flow\trecovery-playbook.md\nConnection and pairing diagnostics\tconnection-diagnostics.md\nBattery and signal reliability\tbattery-maintenance.md\nUnknown AirTag safety workflow\tanti-stalking-safety.md\nCore Rules\n1. Establish Access Mode Before Action\nConfirm whether the user wants Direct App Control, Programmatic API Mode, or Shared Link Mode.\nDo not claim account-level access until one connector is validated and usable.\n2. Use the Least-Exposure Connector That Solves the Task\nPrefer local app control when the user has macOS and Find My already signed in.\nUse API mode only when the user has already configured the connector and explicitly accepts the trust trade-off.\n3. Build an Inventory Before Running Recovery\nStart by enumerating available tags and mapping human aliases to actual items.\nKeep inventory stable during an incident so actions target the correct AirTag.\n4. Run Locate Workflows in Escalation Order\nStart with live locate actions, then stale-location triage, then unknown-location recovery.\nEscalate only after lower-impact steps fail with evidence.\n5. Keep Diagnostics and Pairing Deterministic\nSeparate connector problems (auth/session/permissions) from AirTag problems (battery, range, pairing).\nUse one controlled change at a time and record the result before the next step.\n6. Treat Unknown AirTag Alerts as Safety-Critical\nPrioritize personal safety and risk reduction before technical detail.\nUse anti-stalking-safety.md and avoid speculative attribution.\n7. Ask Before Persisting Logs or Sensitive Context\nAsk for explicit confirmation before any connector action, location pull, or local write in ~/airtag/.\nNever request Apple ID password sharing or guide key extraction inside this skill.\nCommon Traps\nClaiming there is an official public AirTag account API -> false expectation and setup failures.\nSkipping connector validation before locate commands -> no data path and confusing outputs.\nRunning pairing resets before checking account/session health -> unnecessary reconfiguration.\nTreating stale map location as live tracking -> wrong recovery decisions.\nRunning connector actions without explicit user confirmation -> avoidable trust and privacy issues.\nMixing unknown-AirTag safety with normal lost-item flow -> delayed risk mitigation.\nExternal Endpoints\nEndpoint\tData Sent\tPurpose\nhttps://www.icloud.com/find\tiCloud session data and Find My item metadata (API mode only)\tRetrieve account-level item location state\nhttps://find.apple.com\tShared item location data from user-created link\tTemporary access to one lost item for recovery support\n\nNo other data is sent externally.\n\nSecurity & Privacy\n\nData that leaves your machine:\n\nApple account session traffic to Find My services when a connector is active.\nOptional shared-link data when using Shared Link Mode.\n\nData that stays local:\n\nUser-approved incident notes and connector context under ~/airtag/.\n\nThis skill does NOT:\n\nUse undeclared endpoints.\nAsk for raw Apple ID passwords by default.\nStore logs outside ~/airtag/ for this skill.\nModify its own SKILL.md.\nTrust\n\nProgrammatic API Mode depends on third-party tooling for Apple private protocols. Only use that mode if the user explicitly accepts the trust and account-risk trade-offs.\n\nRelated Skills\n\nInstall with clawhub install if user confirms:\n\nios - iOS behavior, permissions, and system troubleshooting\nbluetooth - Bluetooth discovery and connectivity stability workflows\nhomepod - Apple ecosystem troubleshooting patterns for shared environments\ntravel - Lost-item prevention and movement planning during trips\nsiri - Voice command reliability for Apple device interactions\nFeedback\nIf useful: clawhub star airtag\nStay updated: clawhub sync" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/ivangdavila/airtag", "publisherUrl": "https://clawhub.ai/ivangdavila/airtag", "owner": "ivangdavila", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/airtag", "downloadUrl": "https://openagent3.xyz/downloads/airtag", "agentUrl": "https://openagent3.xyz/skills/airtag/agent", "manifestUrl": "https://openagent3.xyz/skills/airtag/agent.json", "briefUrl": "https://openagent3.xyz/skills/airtag/agent.md" } }