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

Застосунок macOS **керує Gateway через launchd** за замовчуванням і не запускає
Gateway як дочірній процес. Спершу він намагається під’єднатися до вже запущеного
Gateway на налаштованому порту; якщо жоден недоступний, він вмикає службу launchd
через зовнішній `openclaw` CLI (без вбудованого середовища виконання). Це дає вам
надійний автозапуск під час входу в систему та перезапуск у разі збоїв.

Режим дочірнього процесу (Gateway запускається безпосередньо застосунком) сьогодні
**не використовується**. Якщо вам потрібніший тісніший зв’язок з інтерфейсом, запускайте Gateway вручну в терміналі.

## Типова поведінка (launchd)

* Застосунок встановлює LaunchAgent для кожного користувача з міткою `ai.openclaw.gateway`
  (або `ai.openclaw.<profile>` під час використання `--profile`/`OPENCLAW_PROFILE`; застарілий `com.openclaw.*` підтримується).
* Коли локальний режим увімкнено, застосунок гарантує, що LaunchAgent завантажений, і
  запускає Gateway за потреби.
* Журнали записуються до шляху журналу gateway launchd (видно в налаштуваннях налагодження).

Поширені команди:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
launchctl bootout gui/$UID/ai.openclaw.gateway
```

Замініть мітку на `ai.openclaw.<profile>`, коли запускаєте іменований профіль.

## Непідписані збірки для розробки

`scripts/restart-mac.sh --no-sign` призначено для швидких локальних збірок, коли у вас немає
ключів підпису. Щоб launchd не вказував на непідписаний бінарний файл реле, це:

* Записує `~/.openclaw/disable-launchagent`.

Підписані запуски `scripts/restart-mac.sh` прибирають це перевизначення, якщо маркер
присутній. Щоб скинути вручну:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
rm ~/.openclaw/disable-launchagent
```

## Режим лише під’єднання

Щоб змусити застосунок macOS **ніколи не встановлювати й не керувати launchd**, запустіть його з
`--attach-only` (або `--no-launchd`). Це встановлює `~/.openclaw/disable-launchagent`,
тож застосунок лише під’єднується до вже запущеного Gateway. Таку саму
поведінку можна перемкнути в налаштуваннях налагодження.

## Віддалений режим

Віддалений режим ніколи не запускає локальний Gateway. Застосунок використовує SSH-тунель до
віддаленого хоста й під’єднується через цей тунель.

## Чому ми віддаємо перевагу launchd

* Автозапуск під час входу в систему.
* Вбудована семантика перезапуску/KeepAlive.
* Передбачувані журнали та нагляд.

Якщо справжній режим дочірнього процесу колись знову знадобиться, його слід задокументувати як
окремий, явний режим лише для розробки.

## Пов’язане

* [застосунок macOS](/uk/platforms/macos)
* [регламент Gateway](/uk/gateway)