OpenClaw für macOS: Build und Installation in Minuten

Jeder Entwickler kennt das: Du willst ein neues Projekt lokal zum Laufen bringen, aber die Toolchain macht Probleme oder Berechtigungen stehen im Weg. Damit du dich nicht mit Versionskonflikten herumschlagen musst, zeigt dir dieser Guide den direkten Weg zur OpenClaw macOS App.

Das Setup auf dem Mac ist eigentlich unkompliziert, wenn man die richtige Reihenfolge einhält. Hier erfährst du, wie du die Umgebung konfigurierst und die App fehlerfrei kompilierst.

macOS Developer Setup

Dieser Guide beschreibt die notwendigen Schritte, um die OpenClaw macOS App aus dem Quellcode zu bauen und auszuführen.

Voraussetzungen

Bevor du die App baust, stelle sicher, dass du Folgendes installiert hast:

1. Xcode 26.2+: Erforderlich für die Swift-Entwicklung.
2. Node.js 24 & pnpm: Empfohlen für das Gateway, das CLI und die Packaging-Scripte. Node 22 LTS (aktuell 22.14+) wird für die Kompatibilität weiterhin unterstützt.

1. Abhängigkeiten installieren

Installiere die projektweiten Abhängigkeiten:

pnpm install

2. App bauen und packen

Um die macOS App zu bauen und in dist/OpenClaw.app zu packen, führe diesen Befehl aus:

./scripts/package-mac-app.sh

Falls du kein Apple Developer ID Zertifikat hast, nutzt das Script automatisch ad-hoc signing (-).

Informationen zu Dev-Modi, Signing-Flags und Team ID Troubleshooting findest du in der macOS App README: https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md

Hinweis: Ad-hoc signierte Apps können Sicherheitsabfragen auslösen. Wenn die App sofort mit “Abort trap 6” abstürzt, schau in den Abschnitt Fehlerbehebung.

3. CLI installieren

Die macOS App erwartet eine globale Installation des openclaw CLI, um Hintergrundaufgaben zu verwalten.

So installierst du es (empfohlen):

1. Öffne die OpenClaw App.
2. Gehe zum Tab General in den Einstellungen.
3. Klicke auf “Install CLI”.

Alternativ kannst du es manuell installieren:

npm install -g openclaw@<version>

Fehlerbehebung

Build schlägt fehl: Toolchain oder SDK Mismatch

Der Build der macOS App setzt das neueste macOS SDK und die Swift 6.2 Toolchain voraus.

System-Abhängigkeiten (erforderlich):

• Neueste macOS Version (via Softwareupdate) (erforderlich für Xcode 26.2 SDKs)
• Xcode 26.2 (Swift 6.2 Toolchain)

Prüfungen:

xcodebuild -version
xcrun swift --version

Wenn die Versionen nicht übereinstimmen, aktualisiere macOS/Xcode und starte den Build erneut.

App stürzt bei Berechtigungsanfrage ab

Wenn die App abstürzt, sobald du den Zugriff auf Speech Recognition oder das Mikrofon erlaubst, liegt das oft an einem beschädigten TCC-Cache oder einem Signatur-Fehler.

Lösung:

1. Setze die TCC-Berechtigungen zurück:

   tccutil reset All ai.openclaw.mac.debug

2. Falls das nicht hilft, ändere die BUNDLE_ID temporär in scripts/package-mac-app.sh, um einen sauberen Neustart seitens macOS zu erzwingen.

Gateway steht dauerhaft auf “Starting…”

Wenn der Gateway-Status dauerhaft auf “Starting…” steht, prüfe, ob ein Zombie-Prozess den Port belegt:

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

Falls ein manueller Prozess den Port belegt, stoppe diesen mit (Strg+C). Als letzte Option kannst du die oben gefundene PID beenden.

---

Du hast Fragen zum Setup oder brauchst Hilfe bei einem spezifischen Fehler? Nutze den AI Setup Assistant.

Nächste Schritte

• CLI Referenz Guide
• Gateway Konfiguration