{
  "title": "Device model database (friendly names)",
  "content": "The macOS companion app shows friendly Apple device model names in the **Instances** UI by mapping Apple model identifiers (e.g. `iPad16,6`, `Mac16,6`) to human-readable names.\n\nThe mapping is vendored as JSON under:\n\n* `apps/macos/Sources/OpenClaw/Resources/DeviceModels/`\n\nWe currently vendor the mapping from the MIT-licensed repository:\n\n* `kyle-seongwoo-jun/apple-device-identifiers`\n\nTo keep builds deterministic, the JSON files are pinned to specific upstream commits (recorded in `apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md`).\n\n## Updating the database\n\n1. Pick the upstream commits you want to pin to (one for iOS, one for macOS).\n2. Update the commit hashes in `apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md`.\n3. Re-download the JSON files, pinned to those commits:\n\n4. Ensure `apps/macos/Sources/OpenClaw/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt` still matches upstream (replace it if the upstream license changes).\n5. Verify the macOS app builds cleanly (no warnings):",
  "code_samples": [
    {
      "code": "4. Ensure `apps/macos/Sources/OpenClaw/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt` still matches upstream (replace it if the upstream license changes).\n5. Verify the macOS app builds cleanly (no warnings):",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h2",
      "text": "Data source",
      "id": "data-source"
    },
    {
      "level": "h2",
      "text": "Updating the database",
      "id": "updating-the-database"
    }
  ],
  "url": "llms-txt#device-model-database-(friendly-names)",
  "links": []
}