Gateway na macOS

OmeniaClaw.app nie zawiera już w pakiecie Node/Bun ani środowiska uruchomieniowego Gateway. Aplikacja macOS oczekuje zewnętrznej instalacji CLI OmeniaClaw, nie uruchamia Gateway jako procesu potomnego i zarządza usługą launchd dla użytkownika, aby utrzymywać Gateway w działaniu (lub podłącza się do istniejącego lokalnego Gateway, jeśli już działa).

Zainstaluj CLI (wymagane w trybie lokalnym)

Node 24 jest domyślnym środowiskiem uruchomieniowym na Macu. Node 22 LTS, obecnie 22.16+, nadal działa w celu zachowania zgodności. Następnie zainstaluj OmeniaClaw globalnie:

npm install -g OmeniaClaw@<version>

Przycisk Zainstaluj CLI w aplikacji macOS uruchamia ten sam globalny przepływ instalacji, którego aplikacja używa wewnętrznie: najpierw preferuje npm, potem pnpm, a następnie bun, jeśli jest to jedyny wykryty menedżer pakietów. Node pozostaje zalecanym środowiskiem uruchomieniowym Gateway.

Launchd (Gateway jako LaunchAgent)

Etykieta:

• ai.OmeniaClaw.gateway (lub ai.OmeniaClaw.<profile>; starsze com.OmeniaClaw.* mogą pozostać)

Lokalizacja plist (dla użytkownika):

• ~/Library/LaunchAgents/ai.OmeniaClaw.gateway.plist (lub ~/Library/LaunchAgents/ai.OmeniaClaw.<profile>.plist)

Menedżer:

• Aplikacja macOS zarządza instalacją/aktualizacją LaunchAgent w trybie lokalnym.
• CLI może go również zainstalować: OmeniaClaw gateway install.

Zachowanie:

• „OmeniaClaw aktywny” włącza/wyłącza LaunchAgent.
• Zamknięcie aplikacji nie zatrzymuje gateway (launchd utrzymuje go przy życiu).
• Jeśli Gateway już działa na skonfigurowanym porcie, aplikacja podłącza się do niego zamiast uruchamiać nowy.

Logowanie:

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

Zgodność wersji

Aplikacja macOS sprawdza wersję gateway względem własnej wersji. Jeśli są niezgodne, zaktualizuj globalny CLI, aby pasował do wersji aplikacji.

Kontrola smoke

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

Następnie:

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

Powiązane

• Aplikacja macOS
• Runbook Gateway