{
  "schemaVersion": "1.0",
  "item": {
    "slug": "apple-find-my-local",
    "name": "Find My",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/loganprit/apple-find-my-local",
    "canonicalUrl": "https://clawhub.ai/loganprit/apple-find-my-local",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/apple-find-my-local",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-find-my-local",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/fm-click.sh",
      "scripts/fm-info.sh",
      "scripts/fm-list.sh",
      "scripts/fm-locate.sh"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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/apple-find-my-local"
    },
    "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/apple-find-my-local",
    "agentPageUrl": "https://openagent3.xyz/skills/apple-find-my-local/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-find-my-local/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-find-my-local/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Find My",
        "body": "Control the native Find My app via Peekaboo. No sketchy APIs or credential sharing.\n\nRun scripts from: cd {skillDir}"
      },
      {
        "title": "Requirements",
        "body": "RequirementDetailsOSmacOS onlyAppsFind My.app (must be open), OpenClaw.app (provides Peekaboo bridge)PermissionsOpenClaw.app needs Screen Recording + Accessibility permissionsPeekabooCLI must be installed and configured"
      },
      {
        "title": "Privacy & Security",
        "body": "What this skill accesses:\n\nLocation data for people, devices, and items in your Find My app\nScreenshots of the Find My window (stored locally in /tmp/)\n\nWhat this skill does NOT do:\n\nNo network requests to third-party services\nNo credential storage or Apple ID access\nNo data exfiltration — all operations are local UI automation\n\nData scope: The skill can see/interact with anything visible in your Find My app, including:\n\nShared locations of family/friends\nDevice locations (yours and Family Sharing members)\nAirTag/item locations\n\nUser awareness: This skill uses mouse clicks and UI automation. You will see the actions happening on screen."
      },
      {
        "title": "Known Limitations",
        "body": "--app \"Find My\" hangs in Peekaboo - use --window-id instead\nSidebar items not accessible - Find My doesn't expose item names via accessibility APIs\nPosition-based selection - Select items by position (1st, 2nd, 3rd...) not by name\nmacOS only - Requires Peekaboo + OpenClaw.app bridge\nExclusive control - User cannot interact with the Mac while skill is running (mouse/clicks conflict)"
      },
      {
        "title": "Quick Reference",
        "body": "ScriptPurposefm-window.shGet window ID and bounds (JSON)fm-screenshot.sh [path]Capture Find My windowfm-tab.sh <tab>Switch tab: people, devices, itemsfm-list.sh [tab]Screenshot + show sidebar positionsfm-select-item.sh <pos> [tab]Select item by position (1, 2, 3...)fm-locate.sh <pos> [tab]Select item and screenshot locationfm-info.sh [path]Open info panel, screenshotfm-play-sound.sh <pos>Attempt to play sound on itemfm-click.sh <x> <y>Click at relative window coords"
      },
      {
        "title": "List available items",
        "body": "./scripts/fm-list.sh items\n# Screenshots the Items tab - view image to see your AirTags/items"
      },
      {
        "title": "Find your keys (if keys are 2nd item in list)",
        "body": "./scripts/fm-locate.sh 2 items\n# Shows location on map, outputs screenshot path"
      },
      {
        "title": "Play sound on keys",
        "body": "./scripts/fm-play-sound.sh 2\n# Selects 2nd item, attempts to click Play Sound\n# May require manual click if button not found"
      },
      {
        "title": "Check on a family member",
        "body": "./scripts/fm-list.sh people\n# View screenshot to see who's listed\n\n./scripts/fm-locate.sh 1 people\n# Shows first person's location"
      },
      {
        "title": "Tab Bar (y ≈ 68 from window top)",
        "body": "TabX PositionPeople~63Devices~154Items~243"
      },
      {
        "title": "Sidebar Items (x ≈ 150)",
        "body": "PositionY Coordinate1st item~1202nd item~1743rd item~2284th item~282(spacing)+54px each"
      },
      {
        "title": "Manual Coordinate Clicks",
        "body": "When automation fails, calculate coordinates manually:\n\n# Get window position\n./scripts/fm-window.sh\n# Output: {\"x\": 824, \"y\": 62, \"width\": 1024, \"height\": 768, \"window_id\": 2248}\n\n# Click at relative position within window\n./scripts/fm-click.sh 150 174   # 2nd sidebar item\n./scripts/fm-click.sh 243 68    # Items tab"
      },
      {
        "title": "Info Panel Actions",
        "body": "After selecting an item, click the ⓘ button on the map popup to open the info panel:\n\nActionDescriptionPlay SoundMake AirTag chirp (items only)DirectionsOpen Maps with directionsShareShare location with othersLost ModeEnable contact info sharingNotificationsConfigure alerts"
      },
      {
        "title": "Troubleshooting",
        "body": "\"Find My window not found\"\n\nEnsure Find My.app is open\nCheck OpenClaw.app is running (provides Peekaboo bridge)\n\nClicks not registering\n\nWindow may have moved - re-run fm-window.sh for fresh coordinates\nEnsure Find My is frontmost before clicking\n\nCan't find Play Sound button\n\nOpen info panel manually (click ⓘ on map popup)\nThen re-run play-sound script"
      },
      {
        "title": "Future Improvements",
        "body": "When Peekaboo fixes --app \"Find My\":\n\nDirect element targeting without coordinate calculation\nReliable accessibility tree for sidebar items\nSimpler automation flows"
      }
    ],
    "body": "Find My\n\nControl the native Find My app via Peekaboo. No sketchy APIs or credential sharing.\n\nRun scripts from: cd {skillDir}\n\nRequirements\nRequirement\tDetails\nOS\tmacOS only\nApps\tFind My.app (must be open), OpenClaw.app (provides Peekaboo bridge)\nPermissions\tOpenClaw.app needs Screen Recording + Accessibility permissions\nPeekaboo\tCLI must be installed and configured\nPrivacy & Security\n\nWhat this skill accesses:\n\nLocation data for people, devices, and items in your Find My app\nScreenshots of the Find My window (stored locally in /tmp/)\n\nWhat this skill does NOT do:\n\nNo network requests to third-party services\nNo credential storage or Apple ID access\nNo data exfiltration — all operations are local UI automation\n\nData scope: The skill can see/interact with anything visible in your Find My app, including:\n\nShared locations of family/friends\nDevice locations (yours and Family Sharing members)\nAirTag/item locations\n\nUser awareness: This skill uses mouse clicks and UI automation. You will see the actions happening on screen.\n\nKnown Limitations\n--app \"Find My\" hangs in Peekaboo - use --window-id instead\nSidebar items not accessible - Find My doesn't expose item names via accessibility APIs\nPosition-based selection - Select items by position (1st, 2nd, 3rd...) not by name\nmacOS only - Requires Peekaboo + OpenClaw.app bridge\nExclusive control - User cannot interact with the Mac while skill is running (mouse/clicks conflict)\nQuick Reference\nScript\tPurpose\nfm-window.sh\tGet window ID and bounds (JSON)\nfm-screenshot.sh [path]\tCapture Find My window\nfm-tab.sh <tab>\tSwitch tab: people, devices, items\nfm-list.sh [tab]\tScreenshot + show sidebar positions\nfm-select-item.sh <pos> [tab]\tSelect item by position (1, 2, 3...)\nfm-locate.sh <pos> [tab]\tSelect item and screenshot location\nfm-info.sh [path]\tOpen info panel, screenshot\nfm-play-sound.sh <pos>\tAttempt to play sound on item\nfm-click.sh <x> <y>\tClick at relative window coords\nWorkflow Examples\nList available items\n./scripts/fm-list.sh items\n# Screenshots the Items tab - view image to see your AirTags/items\n\nFind your keys (if keys are 2nd item in list)\n./scripts/fm-locate.sh 2 items\n# Shows location on map, outputs screenshot path\n\nPlay sound on keys\n./scripts/fm-play-sound.sh 2\n# Selects 2nd item, attempts to click Play Sound\n# May require manual click if button not found\n\nCheck on a family member\n./scripts/fm-list.sh people\n# View screenshot to see who's listed\n\n./scripts/fm-locate.sh 1 people\n# Shows first person's location\n\nUI Layout Reference\nTab Bar (y ≈ 68 from window top)\nTab\tX Position\nPeople\t~63\nDevices\t~154\nItems\t~243\nSidebar Items (x ≈ 150)\nPosition\tY Coordinate\n1st item\t~120\n2nd item\t~174\n3rd item\t~228\n4th item\t~282\n(spacing)\t+54px each\nManual Coordinate Clicks\n\nWhen automation fails, calculate coordinates manually:\n\n# Get window position\n./scripts/fm-window.sh\n# Output: {\"x\": 824, \"y\": 62, \"width\": 1024, \"height\": 768, \"window_id\": 2248}\n\n# Click at relative position within window\n./scripts/fm-click.sh 150 174   # 2nd sidebar item\n./scripts/fm-click.sh 243 68    # Items tab\n\nInfo Panel Actions\n\nAfter selecting an item, click the ⓘ button on the map popup to open the info panel:\n\nAction\tDescription\nPlay Sound\tMake AirTag chirp (items only)\nDirections\tOpen Maps with directions\nShare\tShare location with others\nLost Mode\tEnable contact info sharing\nNotifications\tConfigure alerts\nTroubleshooting\n\n\"Find My window not found\"\n\nEnsure Find My.app is open\nCheck OpenClaw.app is running (provides Peekaboo bridge)\n\nClicks not registering\n\nWindow may have moved - re-run fm-window.sh for fresh coordinates\nEnsure Find My is frontmost before clicking\n\nCan't find Play Sound button\n\nOpen info panel manually (click ⓘ on map popup)\nThen re-run play-sound script\nFuture Improvements\n\nWhen Peekaboo fixes --app \"Find My\":\n\nDirect element targeting without coordinate calculation\nReliable accessibility tree for sidebar items\nSimpler automation flows"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/loganprit/apple-find-my-local",
    "publisherUrl": "https://clawhub.ai/loganprit/apple-find-my-local",
    "owner": "loganprit",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/apple-find-my-local",
    "downloadUrl": "https://openagent3.xyz/downloads/apple-find-my-local",
    "agentUrl": "https://openagent3.xyz/skills/apple-find-my-local/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-find-my-local/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-find-my-local/agent.md"
  }
}