> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm install
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
./scripts/package-mac-app.sh
```

Результат сохраняется в `dist/OpenClaw.app`. Если сертификат Apple Developer ID отсутствует,
сценарий использует специальную подпись.

Режимы запуска для разработки, параметры подписи и устранение неполадок с Team ID описаны в
[apps/macos/README.md](https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md).
Быстрый цикл разработки из корня репозитория: `scripts/restart-mac.sh` (добавьте `--no-sign` для
специальной подписи; разрешения TCC не сохраняются при использовании `--no-sign`).

> [!NOTE]
>
> Приложения со специальной подписью могут вызывать предупреждения системы безопасности. Если приложение
> сразу завершает работу с ошибкой «Abort trap 6», см. раздел [Устранение неполадок](#troubleshooting).

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

В упакованное приложение встроен стандартный установщик `scripts/install-cli.sh`. В
новом профиле во время первоначальной настройки выберите **This Mac**; приложение установит
соответствующие пользовательские CLI и среду выполнения перед запуском мастера Gateway.

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@<version>
```

`pnpm add -g openclaw@<version>` и `bun add -g openclaw@<version>` также
поддерживаются. Node остаётся рекомендуемой средой выполнения для самого Gateway.

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
xcodebuild -version
xcrun swift --version
```

Если версии не соответствуют требованиям, обновите macOS/Xcode и повторите сборку.

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

Если приложение аварийно завершается при попытке разрешить доступ к **Speech Recognition** или
**Microphone**, причиной может быть повреждённый кеш TCC или несовпадение подписи.

1. Сбросьте разрешения TCC для идентификатора отладочного пакета:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   tccutil reset All ai.openclaw.mac.debug
   ```

2. Если это не поможет, временно измените `BUNDLE_ID` в
   [`scripts/package-mac-app.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/package-mac-app.sh),
   чтобы macOS создала настройки с чистого листа.

### Gateway бесконечно отображает «Starting...»

Проверьте, не удерживает ли порт зависший процесс:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway status
openclaw gateway stop

# Если вы не используете LaunchAgent (режим разработки / ручной запуск), найдите прослушивающий процесс:
lsof -nP -iTCP:18789 -sTCP:LISTEN
```

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

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

* [Приложение macOS](https://docs2.openclaw.ai/ru/platforms/macos.md)
* [Обзор установки](https://docs2.openclaw.ai/ru/install.md)