adolf/apps/ios/APP-REVIEW-NOTES.md

App Review Notes

Use these steps to exercise the live OpenClaw iOS App Review Gateway.

Demo Account / Setup

Use the OpenClaw iOS app with the live review Gateway setup code included in the Notes field of this App Review submission.

The setup code is a single generated code string. It already contains the public Gateway host and setup credential.

Setup Walkthrough

1. Open the OpenClaw app.
2. Tap Continue.
3. On Connect Gateway, tap Set Up Manually.
4. In the Setup Code section, tap the Paste setup code field.
5. Paste the setup code string from the App Review submission Notes field.
6. Tap Apply Setup Code.
7. If Trust and connect appears, tap Trust and connect.
8. Wait for the Connected screen.
9. On Connected, tap Open OpenClaw.
10. Confirm the Control screen shows Gateway Online.
11. Tap Settings.
12. Tap Approvals.
13. Tap Open Notifications.
14. Tap Enable Notifications.
15. On Enable OpenClaw Hosted Push Relay?, tap Continue.
16. If iOS asks whether OpenClaw may send notifications, tap Allow.
17. Confirm Notifications shows Enabled.

Chat

1. Tap the Chat tab.
2. Tap the text field labeled Message main....
3. Send this exact message:

Start Apple review checklist.

Expected result: the assistant replies with the available App Review demos.

Approval Demo

1. Tap the Chat tab.
2. Tap the text field labeled Message main....
3. Send this exact message:

Run the approval demo.

Expected result: the iPhone shows Exec approval required with the harmless command printf 'OpenClaw App Review approval demo complete\n'. Tap Allow Once. The chat then replies:

The approval demo completed.

Talk

1. Tap the Talk tab.
2. Tap Start Talk.
3. If iOS asks for microphone access, tap Allow.
4. If iOS asks for Speech Recognition access, tap Allow.
5. Confirm the screen changes to Ready to talk and shows Stop Talk.
6. Say:

Summarize this review setup in one sentence.

Expected result: the assistant responds by voice. Tap Stop Talk when done.

Talk + Background Audio

1. Tap the Talk tab.
2. Confirm the speaker button is highlighted.
3. Confirm the background-listening button is highlighted.
4. Tap Start Talk.
5. If iOS asks for microphone access, tap Allow.
6. If iOS asks for Speech Recognition access, tap Allow.
7. Confirm Stop Talk is visible.
8. Say:

Tell me when you can hear me.

9. While Talk is active, send OpenClaw to the background by returning to the Home Screen or locking the iPhone. Do not force quit the app.
10. Continue speaking then wait for assistant audio reply.

Expected result: realtime Talk audio continues while OpenClaw is backgrounded. Reopen OpenClaw, confirm Talk is still active, then tap Stop Talk.

Gateway Status

1. Tap Control.
2. Tap Instances.
3. Confirm the screen shows Gateway online.
4. Confirm at least one agent row is connected.
5. Confirm the iPhone review device appears in the connected instances list.

Live Activity / Dynamic Island

1. Tap Settings.
2. Tap Reconnect.
3. Immediately send OpenClaw to the background by returning to the Home Screen or locking the iPhone.
4. Watch the Lock Screen or Dynamic Island while the Gateway reconnects.

Expected result: while reconnecting, iOS can show an OpenClaw Live Activity with connection status such as Connecting... or Reconnecting.... On a fast network this status may be brief because OpenClaw ends the Live Activity after the Gateway reconnects successfully.

Push Notification

1. Tap the Chat tab.
2. Tap the text field labeled Message main....
3. Send this exact message:

Start push notification demo.

4. Immediately send OpenClaw to the background and lock the iPhone. Do not force quit the app.

Expected result: the iPhone Lock Screen receives a visible OpenClaw notification with this body:

OpenClaw App Review push notification demo

Tap the notification and unlock the iPhone if prompted. If OpenClaw opens on Control, tap Chat. Expected chat reply:

The push notification demo completed.

Push Wake / Status

1. Tap the Chat tab.
2. Send this exact message:

Start push wake demo.

3. Immediately send OpenClaw to the background and lock the iPhone. Do not force quit the app.
4. Wait for the OpenClaw notification on the Lock Screen. It normally appears about 10 seconds after the message is sent.
5. Tap the notification and unlock the iPhone if prompted. If OpenClaw opens on Control, tap Chat.

Expected result: the app reconnects to the live Gateway and Chat replies:

The push wake and node status demo completed.

Device Permissions

1. Tap Settings.
2. Tap Permissions.
3. Confirm these current app controls are available:
   • Camera
   • Location with Off, While Using, and Always
   • Keep Awake
4. Expand Privacy & Access.
5. Confirm these request controls are available:
   • Contacts / Request Access
   • Calendar (Add Events) / Request Access
   • Calendar (View Events) / Request Full Access
   • Reminders / Request Access

Share Sheet

1. Open Safari.
2. Navigate to https://example.com.
3. Tap the Safari toolbar More button.
4. Tap Share.
5. Tap OpenClaw.
6. Confirm the OpenClaw share extension appears and shows Edit text, then tap Send. and Send to OpenClaw.
7. Tap Send to OpenClaw.

Expected result: the OpenClaw share extension sends the shared Safari page to the live review Gateway and shows Sent to OpenClaw. Returning to OpenClaw Chat shows the shared Example Domain page.