OPENCLAW_CODE_SIGN_STYLE = Automatic

OPENCLAW_DEVELOPMENT_TEAM = YOUR_TEAM_ID

OPENCLAW_APP_BUNDLE_ID = ai.openclaw.client

OPENCLAW_SHARE_BUNDLE_ID = ai.openclaw.client.share

OPENCLAW_ACTIVITY_WIDGET_BUNDLE_ID = ai.openclaw.client.activitywidget

OPENCLAW_WATCH_APP_BUNDLE_ID = ai.openclaw.client.watchkitapp

OPENCLAW_WATCH_EXTENSION_BUNDLE_ID = ai.openclaw.client.watchkitapp.extension

OPENCLAW_APP_BUNDLE_ID = ai.openclawfoundation.app

OPENCLAW_SHARE_BUNDLE_ID = ai.openclawfoundation.app.share

OPENCLAW_ACTIVITY_WIDGET_BUNDLE_ID = ai.openclawfoundation.app.activitywidget

OPENCLAW_WATCH_APP_BUNDLE_ID = ai.openclawfoundation.app.watchkitapp

OPENCLAW_WATCH_EXTENSION_BUNDLE_ID = ai.openclawfoundation.app.watchkitapp.extension

// Leave empty with automatic signing.

OPENCLAW_APP_PROFILE =

Release behavior:

- Local development uses the canonical `ai.openclawfoundation.app*` bundle IDs when the OpenClaw team is available, and unique `ai.openclawfoundation.app.test.*` bundle IDs only for non-canonical fallback teams.

- Beta release uses canonical `ai.openclaw.client*` bundle IDs through a temporary generated xcconfig in `apps/ios/build/BetaRelease.xcconfig`.

- Beta release uses canonical `ai.openclawfoundation.app*` bundle IDs through a temporary generated xcconfig in `apps/ios/build/BetaRelease.xcconfig`.

- Beta release also switches the app to `OpenClawPushTransport=relay`, `OpenClawPushDistribution=official`, and `OpenClawPushAPNsEnvironment=production`.

- The beta flow does not modify `apps/ios/.local-signing.xcconfig` or `apps/ios/LocalSigning.xcconfig`.

- `apps/ios/version.json` is the pinned iOS release version source.

5. If network path is unclear:

- switch to manual host/port + TLS in Gateway Advanced settings

6. In Xcode console, filter for subsystem/category signals:

- `ai.openclaw.ios`

- `ai.openclawfoundation.app`

- `GatewayDiag`

- `APNs registration failed`

7. Validate background expectations:

import OSLog

struct IOSGatewayChatTransport: OpenClawChatTransport {

static let logger = Logger(subsystem: "ai.openclaw", category: "ios.chat.transport")

static let logger = Logger(subsystem: "ai.openclawfoundation.app", category: "ios.chat.transport")

static let defaultChatSendTimeoutMs = 30000

private let gateway: GatewayNodeSession

import os

enum GatewaySettingsStore {

private static let gatewayService = "ai.openclaw.gateway"

private static let nodeService = "ai.openclaw.node"

private static let talkService = "ai.openclaw.talk"

private static let gatewayService = "ai.openclawfoundation.app.gateway"

private static let nodeService = "ai.openclawfoundation.app.node"

private static let talkService = "ai.openclawfoundation.app.talk"

private static let instanceIdDefaultsKey = "node.instanceId"

private static let preferredGatewayStableIDDefaultsKey = "gateway.preferredStableID"

enum GatewayDiagnostics {

private static let logger = Logger(subsystem: "ai.openclawfoundation.app", category: "GatewayDiag")

private static let queue = DispatchQueue(label: "ai.openclaw.gateway.diagnostics")

private static let queue = DispatchQueue(label: "ai.openclawfoundation.app.gateway.diagnostics")

private static let maxLogBytes: Int64 = 512 * 1024

private static let keepLogBytes: Int64 = 256 * 1024

private static let logSizeCheckEveryWrites = 50

}

enum PushRelayRegistrationStore {

private static let service = "ai.openclaw.pushrelay"

private static let service = "ai.openclawfoundation.app.pushrelay"

private static let registrationStateAccount = "registration-state"

private static let appAttestKeyIDAccount = "app-attest-key-id"

private static let appAttestedKeyIDAccount = "app-attested-key-id"

outPath: outPath)

let state = CaptureState()

let recordQueue = DispatchQueue(label: "ai.openclaw.screenrecord")

let recordQueue = DispatchQueue(label: "ai.openclawfoundation.app.screenrecord")

try await self.startCapture(state: state, config: config, recordQueue: recordQueue)

try await Task.sleep(nanoseconds: UInt64(config.durationMs) * 1_000_000)

}

final class WatchConnectivityTransport: NSObject, @unchecked Sendable {

private nonisolated static let logger = Logger(subsystem: "ai.openclaw", category: "watch.messaging")

private nonisolated static let logger = Logger(subsystem: "ai.openclawfoundation.app", category: "watch.messaging")

private let session: WCSession?

private let callbacksLock = NSLock()

private let gateway: GatewayNodeSession

private let options: Options

private let pcmPlayer: PCMStreamingAudioPlaying

private let logger = Logger(subsystem: "ai.openclaw", category: "RealtimeTalkRelay")

private let logger = Logger(subsystem: "ai.openclawfoundation.app", category: "RealtimeTalkRelay")

private let onStatus: (String) -> Void

private let onIssue: (TalkRuntimeIssue) -> Void

private let onSpeakingChanged: (Bool) -> Void

private var incrementalSpeechPrefetch: IncrementalSpeechPrefetchState?

private var incrementalSpeechPrefetchMonitorTask: Task<Void, Never>?

private let logger = Logger(subsystem: "ai.openclaw", category: "TalkMode")

private let logger = Logger(subsystem: "ai.openclawfoundation.app", category: "TalkMode")

private static func nowSeconds() -> TimeInterval {

ProcessInfo.processInfo.systemUptime

@MainActor

final class TalkRealtimeWebRTCSession: NSObject {

private static let logger = Logger(subsystem: "ai.openclaw", category: "TalkRealtimeWebRTC")

private static let logger = Logger(subsystem: "ai.openclawfoundation.app", category: "TalkRealtimeWebRTC")

private static let consultToolName = "openclaw_agent_consult"

private static let controlToolName = "openclaw_agent_control"

private static let defaultOfferURL = "https://api.openai.com/v1/realtime/calls"