---
read_when:
    - De macOS-ontwikkelomgeving instellen
summary: Installatiehandleiding voor ontwikkelaars die aan de macOS-app van OpenClaw werken
title: macOS-ontwikkelomgeving instellen
x-i18n:
    generated_at: "2026-05-07T13:22:42Z"
    model: gpt-5.5
    provider: openai
    source_hash: b39b449570176f44305c98ec4f00482a8b75ad20174b80c93abc45df37ffa0bc
    source_path: platforms/mac/dev-setup.md
    workflow: 16
---

# macOS-ontwikkelaarsinstallatie

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

## Vereisten

Zorg dat je het volgende hebt geïnstalleerd voordat je de app bouwt:

1. **Xcode 26.2+**: Vereist voor Swift-ontwikkeling.
2. **Node.js 24 & pnpm**: Aanbevolen voor de Gateway, CLI en verpakkingsscripts. Node 22 LTS, momenteel `22.16+`, blijft ondersteund voor compatibiliteit.

## 1. Afhankelijkheden installeren

Installeer de projectbrede afhankelijkheden:

```bash
pnpm install
```

## 2. De app bouwen en verpakken

Voer het volgende uit om de macOS-app te bouwen en te verpakken in `dist/OpenClaw.app`:

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

Als je geen Apple Developer ID-certificaat hebt, gebruikt het script automatisch **ad-hoc-ondertekening** (`-`).

Zie de README van de macOS-app voor ontwikkelmodi, ondertekeningsvlaggen en probleemoplossing voor Team ID:
[https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md](https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md)

> **Opmerking**: Ad-hoc ondertekende apps kunnen beveiligingsmeldingen veroorzaken. Als de app onmiddellijk crasht met "Abort trap 6", zie dan de sectie [Probleemoplossing](#probleemoplossing).

## 3. De CLI installeren

De macOS-app verwacht een globale installatie van de `openclaw` CLI om achtergrondtaken te beheren.

**Zo installeer je deze (aanbevolen):**

1. Open de OpenClaw-app.
2. Ga naar het instellingentabblad **Algemeen**.
3. Klik op **"CLI installeren"**.

Je kunt de CLI ook handmatig installeren:

```bash
npm install -g openclaw@<version>
```

`pnpm add -g openclaw@<version>` en `bun add -g openclaw@<version>` werken ook.
Voor de Gateway-runtime blijft Node de aanbevolen route.

## Probleemoplossing

### Build mislukt: toolchain- of SDK-mismatch

De build van de macOS-app verwacht de nieuwste macOS SDK en de Swift 6.2-toolchain.

**Systeemafhankelijkheden (vereist):**

- **Nieuwste macOS-versie die beschikbaar is in Software-update** (vereist door Xcode 26.2-SDK's)
- **Xcode 26.2** (Swift 6.2-toolchain)

**Controles:**

```bash
xcodebuild -version
xcrun swift --version
```

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

### App crasht bij toekennen van toestemming

Als de app crasht wanneer je **Spraakherkenning** of **Microfoon**-toegang probeert toe te staan, kan dit komen door een beschadigde TCC-cache of niet-overeenkomende ondertekening.

**Oplossing:**

1. Stel de TCC-machtigingen opnieuw in:

   ```bash
   tccutil reset All ai.openclaw.mac.debug
   ```

2. Als dat mislukt, wijzig dan tijdelijk de `BUNDLE_ID` in [`scripts/package-mac-app.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/package-mac-app.sh) om macOS een "schone lei" af te dwingen.

### Gateway blijft eindeloos op "Starting..." staan

Als de Gateway-status op "Starting..." blijft staan, controleer dan of een zombieproces de poort bezet houdt:

```bash
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
```

Als een handmatige run de poort bezet houdt, stop dat proces dan (Ctrl+C). Als laatste redmiddel kun je de PID beëindigen die je hierboven hebt gevonden.

## Gerelateerd

- [macOS-app](/nl/platforms/macos)
- [Installatieoverzicht](/nl/install)