Skip to main content

​
macOS-ontwikkelaarsconfiguratie

Bouw de OpenClaw-macOS-app vanuit de broncode en voer deze uit.

​
Vereisten

  • Xcode 26.2+ (Swift 6.2-toolchain), op de nieuwste beschikbare macOS-versie in Software Update.
  • Node.js 24.15+ en pnpm voor de Gateway, CLI en pakketteringsscripts. Node 22.22.3+ werkt ook.

​
1. Afhankelijkheden installeren

​
2. De app bouwen en verpakken

Levert dist/OpenClaw.app op. Zonder een Apple Developer ID-certificaat valt het script terug op ad-hocondertekening. Zie voor ontwikkeluitvoermodi, ondertekeningsvlaggen en probleemoplossing voor Team ID apps/macos/README.md. Snelle ontwikkelcyclus vanuit de hoofdmap van de repository: scripts/restart-mac.sh (voeg --no-sign toe voor ad-hocondertekening; TCC-machtigingen blijven niet behouden met --no-sign).
Ad-hocondertekende apps kunnen beveiligingsmeldingen activeren. Als de app onmiddellijk crasht met “Abort trap 6”, zie Probleemoplossing.

​
3. De CLI en Gateway installeren

De verpakte app bevat het canonieke scripts/install-cli.sh-installatieprogramma. Kies bij een nieuw profiel This Mac tijdens de onboarding; de app installeert de bijpassende CLI en runtime in de gebruikersruimte voordat de Gateway-wizard wordt gestart. Installeer voor handmatig ontwikkelherstel zelf de bijpassende CLI:
pnpm add -g openclaw@<version> en bun add -g openclaw@<version> werken ook. Node blijft de aanbevolen runtime voor de Gateway zelf.

​
Probleemoplossing

​
Bouwen mislukt: toolchain- of SDK-versie komt niet overeen

Voor het bouwen van de macOS-app zijn de nieuwste macOS-SDK en de Swift 6.2-toolchain (Xcode 26.2+) vereist.
Als de versies niet overeenkomen, werk je macOS/Xcode bij en voer je de build opnieuw uit.

​
App crasht bij het verlenen van toestemming

Als de app crasht wanneer je toegang tot Speech Recognition of Microphone probeert toe te staan, kan de oorzaak een beschadigde TCC-cache of niet-overeenkomende ondertekening zijn.
  1. Stel de TCC-machtigingen voor de bundel-ID voor foutopsporing opnieuw in:
  2. Als dat mislukt, wijzig dan tijdelijk BUNDLE_ID in scripts/package-mac-app.sh om macOS met een schone lei te laten beginnen.

​
Gateway blijft voor onbepaalde tijd op “Starting…” staan

Controleer of een zombieproces de poort bezet:
Als een handmatige uitvoering de poort bezet, stop je deze (Ctrl+C) of beëindig je als laatste redmiddel de hierboven gevonden PID.

​
Gerelateerd