Skip to main content

Device model database (friendly names)

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. The mapping is vendored as JSON under apps/macos/Sources/OpenClaw/Resources/DeviceModels/ in the WednesdayAI-apps repository.

Data source

We currently vendor the mapping from the MIT-licensed repository:
  • kyle-seongwoo-jun/apple-device-identifiers
To keep builds deterministic, the JSON files are pinned to specific upstream commits (recorded in NOTICE.md next to the JSON files).

Updating the database

Work in a checkout of the WednesdayAI-apps repository and set MACOS_APP to its apps/macos directory:
  1. Pick the upstream commits you want to pin to (one for iOS, one for macOS).
  2. Update the commit hashes in $MACOS_APP/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md.
  3. Re-download the JSON files, pinned to those commits:
  1. Ensure $MACOS_APP/Sources/OpenClaw/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt still matches upstream (replace it if the upstream license changes).
  2. Verify the macOS app builds cleanly (no warnings):