---
read_when:
    - Упаковка OpenClaw.app
    - Отладка службы launchd Gateway в macOS
    - Установка CLI Gateway для macOS
summary: Среда выполнения Gateway на macOS (внешняя служба launchd)
title: Gateway на macOS
x-i18n:
    generated_at: "2026-06-28T23:12:24Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 5317e82435ecf179407116339507a666957a8e23a07a49665233b22f22f5b155
    source_path: platforms/mac/bundled-gateway.md
    workflow: 16
---

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

## Установка CLI (требуется для локального режима)

Node 24 — среда выполнения по умолчанию на Mac. Node 22 LTS, сейчас `22.19+`, по-прежнему работает для совместимости. Затем установите `openclaw` глобально:

```bash
npm install -g openclaw@<version>
```

Кнопка **Установить CLI** в приложении macOS запускает тот же поток глобальной установки, который приложение
использует внутренне: сначала предпочитается npm, затем pnpm, затем bun, если это единственный
обнаруженный менеджер пакетов. Node остается рекомендуемой средой выполнения Gateway.

## Launchd (Gateway как LaunchAgent)

Метка:

- `ai.openclaw.gateway` (или `ai.openclaw.<profile>`; устаревшие `com.openclaw.*` могут оставаться)

Расположение plist (для пользователя):

- `~/Library/LaunchAgents/ai.openclaw.gateway.plist`
  (или `~/Library/LaunchAgents/ai.openclaw.<profile>.plist`)

Менеджер:

- Приложение macOS управляет установкой/обновлением LaunchAgent в локальном режиме.
- CLI также может установить его: `openclaw gateway install`.

Поведение:

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

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

- stdout launchd: `~/Library/Logs/openclaw/gateway.log` (профили используют `gateway-<profile>.log`)
- stderr launchd: подавляется

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

Приложение macOS проверяет версию gateway относительно собственной версии. Если они
несовместимы, обновите глобальный CLI до версии приложения.

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

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

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

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

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

```bash
cd apps/macos
swift run openclaw-mac connect --json
swift run openclaw-mac discover --timeout 3000 --json
```

`connect` принимает `--url`, `--token`, `--timeout` и `--json`. `discover`
принимает `--timeout`, `--json` и `--include-local`. Сравните вывод обнаружения
с `openclaw gateway discover --json`, когда нужно отделить обнаружение CLI
от проблем подключения на стороне приложения.

## Дымовая проверка

```bash
openclaw --version

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

Затем:

```bash
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000
```

## См. также

- [приложение macOS](/ru/platforms/macos)
- [операционный справочник Gateway](/ru/gateway)