macOS companion app

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

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

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

Передумови

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

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

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

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

bash

pnpm install

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

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

bash

./scripts/package-mac-app.sh

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

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

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

3. Встановіть CLI

Застосунок macOS очікує глобальне встановлення CLI openclaw для керування фоновими завданнями.

Щоб встановити його (рекомендовано):

Відкрийте застосунок OpenClaw.
Перейдіть на вкладку налаштувань General.
Натисніть "Install CLI".

Або встановіть його вручну:

bash

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)

Перевірки:

bash

xcodebuild -versionxcrun swift --version

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

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

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

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

Скиньте дозволи TCC:
bash
```
tccutil reset All ai.openclaw.mac.debug
```
Якщо це не допомогло, тимчасово змініть BUNDLE_ID у scripts/package-mac-app.sh, щоб змусити macOS почати з "чистого аркуша".

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

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

bash

openclaw gateway statusopenclaw gateway stop # If you're not using a LaunchAgent (dev mode / manual runs), find the listener:lsof -nP -iTCP:18789 -sTCP:LISTEN

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

Пов’язане

Was this useful?