---
read_when:
    - Інтеграція застосунку для Mac із життєвим циклом Gateway
summary: Життєвий цикл Gateway у macOS (launchd)
title: Життєвий цикл Gateway на macOS
x-i18n:
    generated_at: "2026-05-06T04:12:38Z"
    model: gpt-5.5
    provider: openai
    source_hash: 543327024f8c635d74ac656923e8e745dc47ca9df0aba5ec51215bd186db2b35
    source_path: platforms/mac/child-process.md
    workflow: 16
---

Застосунок 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
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
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)