Перейти к основному содержанию

Gateway (шлюз) на macOS (внешний launchd)

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

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

На Mac требуется Node 22+, затем установите openclaw глобально:
npm install -g openclaw@<version>
Кнопка Install CLI в приложении для macOS запускает тот же процесс через npm/pnpm (bun не рекомендуется для среды выполнения Gateway (шлюз)).

Launchd (Gateway (шлюз) как LaunchAgent)

Метка:
  • bot.molt.gateway (или bot.molt.<profile>; устаревшая com.openclaw.* может сохраняться)
Расположение plist (для пользователя):
  • ~/Library/LaunchAgents/bot.molt.gateway.plist (или ~/Library/LaunchAgents/bot.molt.<profile>.plist)
Управление:
  • Приложение для macOS управляет установкой/обновлением LaunchAgent в локальном режиме.
  • CLI также может установить его: openclaw gateway install.
Поведение:
  • «OpenClaw Active» включает/выключает LaunchAgent.
  • Закрытие приложения не останавливает gateway (launchd поддерживает его работу).
  • Если Gateway (шлюз) уже запущен на настроенном порту, приложение подключается к нему вместо запуска нового экземпляра.
Метка:
  • stdout/err launchd: /tmp/openclaw/openclaw-gateway.log

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

Приложение для macOS проверяет версию Gateway (шлюз) на соответствие собственной версии. Если они несовместимы, обновите глобальный CLI до версии, соответствующей версии приложения.

Дым

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