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 глобально:

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.

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

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

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

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

Задавайте OPENCLAW_STATE_DIR как локальный путь только при необходимости переопределения. openclaw doctor предупреждает о распространённых путях состояния с облачной синхронизацией и рекомендует вернуться к локальному хранилищу. См. переменные среды и Doctor.

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

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

cd apps/macosswift run openclaw-mac connect --jsonswift run openclaw-mac discover --timeout 3000 --json

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

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

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

Затем:

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

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

• Приложение macOS
• Руководство по эксплуатации Gateway