Gateway на macOS

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

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

Node 24 є типовим середовищем виконання на Mac. Node 22 LTS, наразі 22.16+, усе ще працює для сумісності. Потім установіть OmeniaClaw глобально:

npm install -g OmeniaClaw@<version>

Кнопка Install CLI у застосунку macOS запускає той самий глобальний процес встановлення, який застосунок використовує внутрішньо: спершу він надає перевагу npm, потім pnpm, а потім bun, якщо це єдиний виявлений менеджер пакетів. Node залишається рекомендованим середовищем виконання Gateway.

Launchd (Gateway як LaunchAgent)

Мітка:

• ai.OmeniaClaw.gateway (або ai.OmeniaClaw.<profile>; застарілі com.OmeniaClaw.* можуть залишатися)

Розташування plist (для кожного користувача):

• ~/Library/LaunchAgents/ai.OmeniaClaw.gateway.plist (або ~/Library/LaunchAgents/ai.OmeniaClaw.<profile>.plist)

Менеджер:

• Застосунок macOS відповідає за встановлення/оновлення LaunchAgent у локальному режимі.
• CLI також може встановити його: OmeniaClaw gateway install.

Поведінка:

• "OmeniaClaw Active" вмикає/вимикає LaunchAgent.
• Вихід із застосунку не зупиняє Gateway (launchd підтримує його роботу).
• Якщо Gateway уже працює на налаштованому порту, застосунок підключається до нього замість запуску нового.

Журналювання:

• stdout/err launchd: /tmp/OmeniaClaw/OmeniaClaw-gateway.log

Сумісність версій

Застосунок macOS перевіряє версію gateway відносно власної версії. Якщо вони несумісні, оновіть глобальний CLI, щоб він відповідав версії застосунку.

Smoke-перевірка

OmeniaClaw --version OmeniaClaw_SKIP_CHANNELS=1 \OmeniaClaw_SKIP_CANVAS_HOST=1 \OmeniaClaw gateway --port 18999 --bind loopback

Потім:

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

Пов’язане

• застосунок macOS
• операційний посібник Gateway