Skip to main content

​
Настройка среды разработки macOS

Сборка и запуск приложения OpenClaw для macOS из исходного кода.

​
Предварительные требования

  • Xcode 26.2+ (набор инструментов Swift 6.2) и последняя версия macOS, доступная в Software Update.
  • Node.js 24.15+ и pnpm для Gateway, CLI и сценариев упаковки. Node 22.22.3+ также поддерживается.

​
1. Установите зависимости

​
2. Соберите и упакуйте приложение

Результат сохраняется в dist/OpenClaw.app. Если сертификат Apple Developer ID отсутствует, сценарий использует специальную подпись. Режимы запуска для разработки, параметры подписи и устранение неполадок с Team ID описаны в apps/macos/README.md. Быстрый цикл разработки из корня репозитория: scripts/restart-mac.sh (добавьте --no-sign для специальной подписи; разрешения TCC не сохраняются при использовании --no-sign).
Приложения со специальной подписью могут вызывать предупреждения системы безопасности. Если приложение сразу завершает работу с ошибкой «Abort trap 6», см. раздел Устранение неполадок.

​
3. Установите CLI и Gateway

В упакованное приложение встроен стандартный установщик scripts/install-cli.sh. В новом профиле во время первоначальной настройки выберите This Mac; приложение установит соответствующие пользовательские CLI и среду выполнения перед запуском мастера Gateway. Для ручного восстановления среды разработки самостоятельно установите соответствующую версию CLI:
pnpm add -g openclaw@<version> и bun add -g openclaw@<version> также поддерживаются. Node остаётся рекомендуемой средой выполнения для самого Gateway.

​
Устранение неполадок

​
Сбой сборки: несовместимость набора инструментов или SDK

Для сборки приложения macOS требуются последняя версия macOS SDK и набор инструментов Swift 6.2 (Xcode 26.2+).
Если версии не соответствуют требованиям, обновите macOS/Xcode и повторите сборку.

​
Приложение аварийно завершается при предоставлении разрешения

Если приложение аварийно завершается при попытке разрешить доступ к Speech Recognition или Microphone, причиной может быть повреждённый кеш TCC или несовпадение подписи.
  1. Сбросьте разрешения TCC для идентификатора отладочного пакета:
  2. Если это не поможет, временно измените BUNDLE_ID в scripts/package-mac-app.sh, чтобы macOS создала настройки с чистого листа.

​
Gateway бесконечно отображает «Starting…»

Проверьте, не удерживает ли порт зависший процесс:
Если порт удерживается процессом, запущенным вручную, остановите его (Ctrl+C) или в крайнем случае завершите процесс с найденным выше PID.

​
Связанные материалы