Device model database

The macOS companion app shows friendly Apple device model names in the Instances UI by mapping Apple model identifiers (e.g.

, ) to human-readable names.

The mapping is vendored as JSON under:

• text

  Copy

  apps/macos/Sources/OpenClaw/Resources/DeviceModels/

Data source

We currently vendor the mapping from the MIT-licensed repository:

• text

  Copy

  kyle-seongwoo-jun/apple-device-identifiers

To keep builds deterministic, the JSON files are pinned to specific upstream commits (recorded in

).

Updating the database

1. Pick the upstream commits you want to pin to (one for iOS, one for macOS).
2. Update the commit hashes in
   text

   Copy

   apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md
   .
3. Re-download the JSON files, pinned to those commits:

bash
Copy
IOS_COMMIT="<commit sha for ios-device-identifiers.json>"
MAC_COMMIT="<commit sha for mac-device-identifiers.json>"

curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/${IOS_COMMIT}/ios-device-identifiers.json" \
  -o apps/macos/Sources/OpenClaw/Resources/DeviceModels/ios-device-identifiers.json

curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/${MAC_COMMIT}/mac-device-identifiers.json" \
  -o apps/macos/Sources/OpenClaw/Resources/DeviceModels/mac-device-identifiers.json

4. Ensure
   text

   Copy

   apps/macos/Sources/OpenClaw/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt
   still matches upstream (replace it if the upstream license changes).
5. Verify the macOS app builds cleanly (no warnings):

bash
Copy
swift build --package-path apps/macos

Related

• Nodes
• Node troubleshooting