Настройка среды разработки 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

Приложение macOS ожидает глобальную установку CLI openclaw для управления фоновыми задачами.

Чтобы установить его (рекомендуется):

1. Откройте приложение OpenClaw.
2. Перейдите на вкладку настроек Общие.
3. Нажмите "Установить 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, доступная в «Обновлении ПО» (требуется для 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 остается «Запуск...», проверьте, не удерживает ли порт зомби-процесс:

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.

См. также

• Приложение macOS
• Обзор установки