OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

macOS companion app

macOS-ontwikkelomgeving instellen

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 macOS-versie die beschikbaar is via Software Update.
  • Node.js 24 en pnpm voor de Gateway, CLI en verpakkingsscripts. Node 22.19+ werkt ook.

1. Afhankelijkheden installeren

bash
pnpm install

2. De app bouwen en verpakken

bash
./scripts/package-mac-app.sh

Dit levert dist/OpenClaw.app op. Zonder een Apple Developer ID-certificaat valt het script terug op ad-hocondertekening.

Zie voor ontwikkelmodi, ondertekeningsvlaggen en het oplossen van problemen met de 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).

3. De CLI en Gateway installeren

De verpakte app bevat het canonieke installatieprogramma scripts/install-cli.sh. Kies bij een nieuw profiel tijdens de eerste configuratie This Mac; de app installeert de bijbehorende CLI en runtime in de gebruikersomgeving voordat de Gateway-wizard wordt gestart.

Installeer voor handmatig herstel tijdens de ontwikkeling zelf de bijbehorende CLI:

bash
npm install -g openclaw@<version>

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 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.

bash
xcodebuild -versionxcrun swift --version

Als de versies niet overeenkomen, werk macOS/Xcode dan bij en voer de build opnieuw uit.

App loopt vast bij het verlenen van machtigingen

Als de app vastloopt wanneer u toegang tot Speech Recognition of Microphone probeert toe te staan, kan dit worden veroorzaakt door een beschadigde TCC-cache of een niet-overeenkomende ondertekening.

  1. Stel de TCC-machtigingen voor de bundel-ID voor foutopsporing opnieuw in:

    bash
    tccutil reset All ai.openclaw.mac.debug

  2. Als dat niet werkt, wijzig dan tijdelijk BUNDLE_ID in scripts/package-mac-app.sh om macOS met een schone lei te laten beginnen.

Gateway blijft onbeperkt op "Starting..." staan

Controleer of een zombieproces de poort bezet houdt:

bash
openclaw gateway statusopenclaw gateway stop # Als u geen LaunchAgent gebruikt (ontwikkelmodus / handmatige uitvoeringen), zoek dan het luisterende proces:lsof -nP -iTCP:18789 -sTCP:LISTEN

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

Gerelateerd

Was this useful?
On this page

On this page