Налаштування розробника macOS

Зберіть і запустіть застосунок OpenClaw для macOS із вихідного коду.

Передумови

Перед збиранням застосунку переконайтеся, що у вас установлено таке:

1. Xcode 26.2+: потрібен для розробки на Swift.
2. Node.js 24 і pnpm: рекомендовано для Gateway, CLI та скриптів пакування. Node 22 LTS, наразі 22.19+, і далі підтримується для сумісності.

1. Установіть залежності

Установіть залежності для всього проєкту:

pnpm install

2. Зберіть і запакуйте застосунок

Щоб зібрати застосунок macOS і запакувати його в dist/OpenClaw.app, виконайте:

./scripts/package-mac-app.sh

Якщо у вас немає сертифіката Apple Developer ID, скрипт автоматично використає ad-hoc підписування (-).

Про режими запуску для розробки, прапорці підписування та усунення проблем із Team ID див. README застосунку macOS: https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md

Примітка: застосунки з ad-hoc підписуванням можуть викликати запити безпеки. Якщо застосунок одразу аварійно завершується з "Abort trap 6", див. розділ Усунення несправностей.

3. Установіть CLI і Gateway

Запакований застосунок вбудовує канонічний інсталятор scripts/install-cli.sh. У новому профілі під час онбордингу виберіть Цей Mac; застосунок установлює відповідні користувацькі CLI і середовище виконання перед запуском майстра Gateway.

Для ручного відновлення середовища розробки самостійно встановіть відповідний CLI:

npm install -g openclaw@<version>

pnpm add -g openclaw@<version> і bun add -g openclaw@<version> також працюють. Для середовища виконання Gateway Node і далі є рекомендованим шляхом.

Усунення несправностей

Збирання не вдається: невідповідність toolchain або SDK

Збирання застосунку macOS очікує найновіший macOS SDK і toolchain Swift 6.2.

Системні залежності (обов’язково):

• Найновіша версія macOS, доступна в Software Update (потрібна для SDK Xcode 26.2)
• Xcode 26.2 (toolchain Swift 6.2)

Перевірки:

xcodebuild -versionxcrun swift --version

Якщо версії не збігаються, оновіть macOS/Xcode і повторно запустіть збирання.

Застосунок аварійно завершується під час надання дозволу

Якщо застосунок аварійно завершується, коли ви намагаєтеся дозволити доступ до Розпізнавання мовлення або Мікрофона, причиною може бути пошкоджений кеш TCC або невідповідність підпису.

Виправлення:

1. Скиньте дозволи TCC:

   tccutil reset All ai.openclaw.mac.debug

2. Якщо це не допоможе, тимчасово змініть BUNDLE_ID у scripts/package-mac-app.sh, щоб macOS почала з "чистого аркуша".

Gateway нескінченно показує "Запуск..."

Якщо стан Gateway залишається "Запуск...", перевірте, чи не утримує порт zombie-процес:

openclaw gateway statusopenclaw gateway stop # Якщо ви не використовуєте LaunchAgent (режим розробки / ручні запуски), знайдіть слухача:lsof -nP -iTCP:18789 -sTCP:LISTEN

Якщо порт утримує ручний запуск, зупиніть цей процес (Ctrl+C). Як крайній захід, завершіть PID, знайдений вище.

Пов’язано

• Застосунок macOS
• Огляд установлення