Hoppa till huvudinnehåll

​
macOS-utvecklarsetup

Den här guiden beskriver de nödvändiga stegen för att bygga och köra OpenClaw macOS-applikationen från källkod.

​
Förutsättningar

Innan du bygger appen, säkerställ att du har följande installerat:
  1. Xcode 26.2+: Krävs för Swift-utveckling.
  2. Node.js 22+ & pnpm: Krävs för gateway (nätverksgateway), CLI och paketeringsskript.

​
1) Installera beroenden

Installera projektets gemensamma beroenden: 
pnpm install

​
2. Bygg och paketera appen

För att bygga macOS-appen och paketera den till dist/OpenClaw.app, kör: 
./scripts/package-mac-app.sh
Om du inte har ett Apple Developer ID-certifikat kommer skriptet automatiskt att använda ad-hoc-signering (-). För utvecklingskörlägen, signeringsflaggor och felsökning av Team ID, se macOS-appens README: https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md
Observera: Ad-hoc signerade appar kan utlösa säkerhetsmeddelanden. Om appen kraschar omedelbart med “Avbryt fällan 6”, se avsnittet Troubleshooting .

​
3. Installera CLI

macOS-appen förväntar sig en global openclaw-CLI-installation för att hantera bakgrundsuppgifter. Så installerar du den (rekommenderas):
  1. Öppna OpenClaw-appen.
  2. Gå till inställningsfliken Allmänt.
  3. Klicka på ”Installera CLI”.
Alternativt kan du installera den manuellt: 
npm install -g openclaw@<version>

​
Felsökning

​
Bygget misslyckas: Verktygskedja eller SDK stämmer inte

Bygget av macOS-appen förväntar sig den senaste macOS SDK:n och Swift 6.2-verktygskedjan. Systemberoenden (krävs):
  • Senaste macOS-versionen som finns tillgänglig via Programuppdatering (krävs av Xcode 26.2 SDK:er)
  • Xcode 26.2 (Swift 6.2-verktygskedja)
Kontroller: 
xcodebuild -version
xcrun swift --version
Om versionerna inte matchar, uppdatera macOS/Xcode och kör bygget igen.

​
Appen kraschar vid tilldelning av behörigheter

Om appen kraschar när du försöker tillåta åtkomst till Taligenkänning eller Mikrofon, kan det bero på en skadad TCC-cache eller en signaturkonflikt. Åtgärd:
  1. Återställ TCC-behörigheterna: 
    tccutil reset All bot.molt.mac.debug
  2. Om det inte hjälper, ändra BUNDLE_ID tillfälligt i scripts/package-mac-app.sh för att tvinga en ”ren start” från macOS.

​
Gateway (nätverksgateway) ”Starting…” i all oändlighet

Om gateway-statusen förblir ”Starting…”, kontrollera om en zombieprocess håller porten: 
openclaw gateway status
openclaw gateway stop

# If you’re not using a LaunchAgent (dev mode / manual runs), find the listener:
lsof -nP -iTCP:18789 -sTCP:LISTEN
Om en manuell körning håller i hamnen, stoppa den processen (Ctrl+C). Som en sista utväg, döda PID du hittat ovan.