> ## 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.

# Gateway в macOS

OpenClaw\.app не включает в комплект Node или среду выполнения Gateway. Приложение macOS
предполагает **внешнюю** установку CLI `openclaw`, не запускает Gateway
как дочерний процесс и управляет пользовательской службой launchd, чтобы Gateway
продолжал работать (либо подключается к уже запущенному локальному Gateway).

## Автоматическая настройка

На новом Mac во время первоначальной настройки выберите **Этот Mac**. Перед мастером
Gateway приложение запускает входящий в комплект подписанный сценарий установки: он устанавливает
Node в пользовательское пространство и соответствующий CLI `openclaw` в `~/.openclaw`,
а затем устанавливает и запускает пользовательскую службу launchd. Для этого
не требуются Terminal, Homebrew или права администратора.

В комплект приложения входит только сценарий установки, но не компоненты Node или Gateway;
для загрузки среды выполнения и соответствующего пакета OpenClaw во время настройки требуется
подключение к интернету.

## Восстановление вручную

Для установки вручную рекомендуется Node 24.15+; Node 22.22.3+ также поддерживается. Установите
`openclaw` глобально:

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

После сбоя автоматической настройки используйте **Повторить настройку**. Если это также не поможет,
установите CLI вручную с помощью приведённой выше команды, а затем выберите **Проверить снова**
во время первоначальной настройки.

## Launchd (Gateway как LaunchAgent)

Метка: `ai.openclaw.gateway` (профиль по умолчанию) или `ai.openclaw.<profile>`
для именованного профиля.

Расположение plist (для пользователя): `~/Library/LaunchAgents/ai.openclaw.gateway.plist`
(или `ai.openclaw.<profile>.plist`).

В локальном режиме приложение macOS управляет установкой и обновлением LaunchAgent
для профиля по умолчанию. CLI также может установить его напрямую: `openclaw gateway install`
(именованные профили выбираются с помощью переменной среды `OPENCLAW_PROFILE`).

Поведение:

* «OpenClaw активен» включает или отключает LaunchAgent.
* Завершение работы приложения **не** останавливает Gateway (launchd поддерживает его работу).
* Если Gateway уже работает на настроенном порту, приложение подключается
  к нему вместо запуска нового экземпляра.

Журналирование:

* Стандартный вывод launchd: `~/Library/Logs/openclaw/gateway.log` (для профилей используется
  `gateway-<profile>.log`)
* Стандартный поток ошибок launchd: подавляется
* Если хост зацикливается с повторяющимися `EADDRINUSE` или быстрыми перезапусками, проверьте
  наличие дублирующихся LaunchAgent `ai.openclaw.gateway` / `ai.openclaw.node` и обходное решение
  с маркером launchd в разделе
  [Устранение неполадок Gateway](https://docs2.openclaw.ai/ru/gateway/troubleshooting.md#macos-launchd-supervisor-loop-with-duplicate-gatewaynode-launchagents).

## Совместимость версий

Приложение macOS сравнивает версию Gateway со своей версией. Во время первоначальной настройки
управляемая установка запускается автоматически, если существующий CLI отсутствует или
несовместим. Используйте **Повторить настройку**, чтобы повторить установку, или **Проверить снова**
после восстановления внешнего CLI.

## Каталог состояния в macOS

Храните состояние OpenClaw на локальном несинхронизируемом диске. Не используйте iCloud Drive и другие
папки с облачной синхронизацией: задержки синхронизации и блокировки файлов могут влиять на сеансы,
учётные данные и состояние Gateway.

Задавайте `OPENCLAW_STATE_DIR` как локальный путь только при необходимости переопределения.
`openclaw doctor` предупреждает о распространённых путях состояния с облачной синхронизацией и рекомендует
вернуться к локальному хранилищу. См.
[переменные среды](https://docs2.openclaw.ai/ru/help/environment.md#path-related-env-vars) и
[Doctor](https://docs2.openclaw.ai/ru/gateway/doctor.md).

## Отладка подключения приложения

Используйте отладочный CLI для macOS из рабочей копии исходного кода, чтобы проверить ту же логику
WebSocket-рукопожатия и обнаружения Gateway, которую использует приложение:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
cd apps/macos
swift run openclaw-mac connect --json
swift run openclaw-mac discover --timeout 3000 --json
```

`connect` принимает `--url`, `--token`, `--timeout`, `--probe` и `--json`
(а также переопределения идентификации клиента; для полного списка запустите с `--help`).
`discover` принимает `--timeout`, `--json` и `--include-local`. Чтобы
отделить проблемы обнаружения CLI от проблем подключения на стороне приложения, сравните
результат обнаружения с `openclaw gateway discover --json`.

## Быстрая проверка

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw --version

OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
```

Затем:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000
```

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

* [Приложение macOS](https://docs2.openclaw.ai/ru/platforms/macos.md)
* [Руководство по эксплуатации Gateway](https://docs2.openclaw.ai/ru/gateway.md)