Konfiguracja środowiska programistycznego macOS

Zbuduj i uruchom aplikację OpenClaw dla macOS z kodu źródłowego.

Wymagania wstępne

• Xcode 26.2+ (zestaw narzędzi Swift 6.2) na najnowszej dostępnej wersji macOS zainstalowanej za pomocą Software Update.
• Node.js 24 i pnpm do obsługi Gateway, CLI i skryptów pakowania. Node 22.19+ również działa.

1. Zainstaluj zależności

pnpm install

2. Zbuduj i spakuj aplikację

./scripts/package-mac-app.sh

Wynikiem jest dist/OpenClaw.app. Bez certyfikatu Apple Developer ID skrypt użyje awaryjnie podpisu ad hoc.

Informacje o trybach uruchamiania deweloperskiego, opcjach podpisywania i rozwiązywaniu problemów z identyfikatorem zespołu znajdziesz w apps/macos/README.md. Szybka pętla programistyczna z katalogu głównego repozytorium: scripts/restart-mac.sh (dodaj --no-sign, aby użyć podpisu ad hoc; uprawnienia TCC nie są zachowywane przy użyciu --no-sign).

3. Zainstaluj CLI i Gateway

Spakowana aplikacja zawiera kanoniczny instalator scripts/install-cli.sh. W nowym profilu wybierz This Mac podczas wdrażania; aplikacja zainstaluje pasujące CLI oraz środowisko uruchomieniowe w przestrzeni użytkownika przed uruchomieniem kreatora Gateway.

Aby ręcznie przywrócić środowisko programistyczne, samodzielnie zainstaluj pasującą wersję CLI:

npm install -g openclaw@<version>

Polecenia pnpm add -g openclaw@<version> i bun add -g openclaw@<version> również działają. Node pozostaje zalecanym środowiskiem uruchomieniowym dla samego Gateway.

Rozwiązywanie problemów

Kompilacja nie powiodła się: niezgodność zestawu narzędzi lub SDK

Kompilacja aplikacji dla macOS wymaga najnowszego SDK macOS oraz zestawu narzędzi Swift 6.2 (Xcode 26.2+).

xcodebuild -versionxcrun swift --version

Jeśli wersje są niezgodne, zaktualizuj macOS i Xcode, a następnie ponownie uruchom kompilację.

Aplikacja ulega awarii podczas przyznawania uprawnień

Jeśli aplikacja ulega awarii podczas próby zezwolenia na dostęp do Speech Recognition lub Microphone, przyczyną może być uszkodzona pamięć podręczna TCC albo niezgodność podpisu.

1. Zresetuj uprawnienia TCC dla identyfikatora pakietu debugowania:

   tccutil reset All ai.openclaw.mac.debug

2. Jeśli to nie pomoże, tymczasowo zmień BUNDLE_ID w scripts/package-mac-app.sh, aby wymusić utworzenie czystego stanu w macOS.

Gateway bez końca wyświetla „Starting...”

Sprawdź, czy proces zombie nie zajmuje portu:

openclaw gateway statusopenclaw gateway stop # Jeśli nie używasz LaunchAgent (tryb deweloperski / uruchamianie ręczne), znajdź proces nasłuchujący:lsof -nP -iTCP:18789 -sTCP:LISTEN

Jeśli ręcznie uruchomiony proces zajmuje port, zatrzymaj go (Ctrl+C) lub, w ostateczności, zakończ proces o identyfikatorze PID znalezionym powyżej.

Powiązane materiały

• Aplikacja dla macOS
• Omówienie instalacji