macOS companion app
Gateway na macOS
OpenClaw.app nie zawiera już w pakiecie Node/Bun ani środowiska uruchomieniowego Gateway. Aplikacja macOS
oczekuje zewnętrznej instalacji CLI openclaw, 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 openclaw globalnie:
npm install -g openclaw@<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.openclaw.gateway(lubai.openclaw.<profile>; starszecom.openclaw.*mogą pozostać)
Lokalizacja plist (dla użytkownika):
~/Library/LaunchAgents/ai.openclaw.gateway.plist(lub~/Library/LaunchAgents/ai.openclaw.<profile>.plist)
Menedżer:
- Aplikacja macOS zarządza instalacją/aktualizacją LaunchAgent w trybie lokalnym.
- CLI może go również zainstalować:
openclaw gateway install.
Zachowanie:
- „OpenClaw 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/openclaw/openclaw-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
openclaw --version
OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
Następnie:
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000