Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Застосунок 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 (видно в налаштуваннях налагодження).
Поширені команди: 
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 прибирають це перевизначення, якщо маркер присутній. Щоб скинути вручну: 
rm ~/.openclaw/disable-launchagent

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

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

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

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

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

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

​
Пов’язане