mirror of https://github.com/openclaw/openclaw.git synced 2026-08-05 13:21:38 +00:00

Files

Vincent Koc b0a091644f fix(macos): prevent app stalls from stuck subprocess probes (#115938 )

* refactor(macos): pin subprocess groups through cleanup

* refactor(macos): keep bounded process probes async

* test(macos): cover async process probe limits

* fix(macos): preserve local gateway version fallback

* test(macos): cover gateway version probe fallback

* fix(macos): handle subprocesses that exit before monitoring

* test(macos): stress instant bounded process exits

* fix(macos): close bounded process exit registration race

* fix(macos): preserve bounded probe output ordering

* fix(macos): propagate bounded process cancellation

* fix(macos): recover missed subprocess exit events

* chore(macos): refresh native i18n inventory

* fix(macos): reject invalid process argument bytes

2026-07-29 20:12:35 +00:00

Icon.icon

…

Packaging

feat(macos): refresh DMG installer artwork (#107142 )

2026-07-13 22:09:36 -07:00

Sources

fix(macos): prevent app stalls from stuck subprocess probes (#115938 )

2026-07-29 20:12:35 +00:00

Tests/OpenClawIPCTests

fix(macos): prevent app stalls from stuck subprocess probes (#115938 )

2026-07-29 20:12:35 +00:00

.periphery.yml

ci(macos): add enforced periphery dead-code lane and delete the 12 current findings (#105743 )

2026-07-12 16:39:15 -07:00

Package.resolved

build(deps): bump the swift-deps group across 1 directory with 2 updates (#114452 )

2026-07-27 21:58:03 -04:00

Package.swift

fix(macos): prevent remote discovery hangs during Tailscale checks (#115852 )

2026-07-29 21:38:57 +08:00

README.md

fix(macos): support background-only launches (#112168 )

2026-07-21 15:41:49 +08:00

README.md

OpenClaw macOS app (dev + signing)

Quick dev run

# from repo root
scripts/restart-mac.sh

Options:

scripts/restart-mac.sh --no-sign   # fastest dev; ad-hoc signing (TCC permissions do not stick)
scripts/restart-mac.sh --sign      # force code signing (requires cert)
scripts/restart-mac.sh --background-only # keep services running without automatic windows

--background-only suppresses first-run onboarding, update and CLI prompts, and the --chat/--dashboard auto-open helpers. Pairing, control-channel, and Mac node services still start. Combine it with --attach-only when an external process owns the local Gateway.

Packaging flow

scripts/package-mac-app.sh

Creates dist/OpenClaw.app and signs it via scripts/codesign-mac-app.sh.

Signing behavior

Auto-selects identity (first match):

Developer ID Application
Apple Distribution
Apple Development
first available identity

If none found:

errors by default
set ALLOW_ADHOC_SIGNING=1 or SIGN_IDENTITY="-" to ad-hoc sign

Team ID audit (Sparkle mismatch guard)

After signing, we read the app bundle Team ID and compare every Mach-O inside the app. If any embedded binary has a different Team ID, signing fails.

Skip the audit:

SKIP_TEAM_ID_CHECK=1 scripts/package-mac-app.sh

Library validation workaround (dev only)

If Sparkle Team ID mismatch blocks loading (common with Apple Development certs), opt in:

DISABLE_LIBRARY_VALIDATION=1 scripts/package-mac-app.sh

This adds com.apple.security.cs.disable-library-validation to app entitlements. Use for local dev only; keep off for release builds.

Useful env flags

SIGN_IDENTITY="Apple Development: Your Name (TEAMID)"
ALLOW_ADHOC_SIGNING=1 (ad-hoc, TCC permissions do not persist)
CODESIGN_TIMESTAMP=off (offline debug)
DISABLE_LIBRARY_VALIDATION=1 (dev-only Sparkle workaround)
SKIP_TEAM_ID_CHECK=1 (bypass audit)