> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway na macOS

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

## Automatyczna konfiguracja

Na świeżym Macu wybierz **Ten Mac** podczas onboardingu. Aplikacja uruchamia swój podpisany,
dołączony instalator przed kreatorem Gateway, instaluje środowisko uruchomieniowe Node w przestrzeni użytkownika
i pasujące `openclaw` CLI w `~/.openclaw`, a następnie instaluje i uruchamia
usługę launchd dla użytkownika. Ta ścieżka nie wymaga Terminala, Homebrew ani
dostępu administratora.

Aplikacja zawiera w pakiecie skrypt instalatora, a nie ładunek Node ani Gateway. Konfiguracja
wymaga więc połączenia z internetem, aby pobrać środowisko uruchomieniowe i pasujący
pakiet OpenClaw.

## Ręczne odzyskiwanie

Node 24 jest zalecany do ręcznej instalacji. Node 22 LTS, obecnie `22.19+`,
również działa. Następnie zainstaluj `openclaw` globalnie:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@<version>
```

Użyj **Ponów konfigurację** po nieudanej automatycznej konfiguracji. Jeśli to nadal się nie powiedzie, zainstaluj
CLI ręcznie za pomocą powyższego polecenia, a następnie wybierz **Sprawdź ponownie** w
onboardingu. Node pozostaje zalecanym środowiskiem uruchomieniowym Gateway.

## Launchd (Gateway jako LaunchAgent)

Etykieta:

* `ai.openclaw.gateway` (lub `ai.openclaw.<profile>`; starsze `com.openclaw.*` może pozostać)

Lokalizacja plist (dla użytkownika):

* `~/Library/LaunchAgents/ai.openclaw.gateway.plist`
  (lub `~/Library/LaunchAgents/ai.openclaw.<profile>.plist`)

Menedżer:

* Aplikacja macOS odpowiada za instalację/aktualizację LaunchAgent w trybie lokalnym.
* CLI też może go 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 dołącza do
  niego zamiast uruchamiać nowy.

Logowanie:

* stdout launchd: `~/Library/Logs/openclaw/gateway.log` (profile używają `gateway-<profile>.log`)
* stderr launchd: wyciszone

## Zgodność wersji

Aplikacja macOS sprawdza wersję Gateway względem własnej wersji. Onboarding
automatycznie uruchamia zarządzaną konfigurację, gdy istniejącego CLI brakuje albo jest
niezgodne. Użyj **Ponów konfigurację**, aby powtórzyć instalację, albo **Sprawdź ponownie**
po naprawieniu zewnętrznego CLI.

## Katalog stanu w macOS

Przechowuj stan OpenClaw na lokalnym, niesynchronizowanym dysku. Unikaj iCloud Drive i innych
folderów synchronizowanych z chmurą, ponieważ opóźnienia synchronizacji i blokady plików mogą wpływać na sesje,
dane uwierzytelniające i stan Gateway.

Ustaw `OPENCLAW_STATE_DIR` na ścieżkę lokalną tylko wtedy, gdy potrzebujesz nadpisania.
`openclaw doctor` ostrzega przed typowymi ścieżkami stanu synchronizowanymi z chmurą i zaleca
powrót do lokalnej pamięci. Zobacz
[zmienne środowiskowe](/pl/help/environment#path-related-env-vars) i
[Doctor](/pl/gateway/doctor).

## Debugowanie łączności aplikacji

Użyj debugowego CLI macOS z checkoutu źródeł, aby wykonać ten sam handshake WebSocket
Gateway i logikę wykrywania, których używa aplikacja:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
cd apps/macos
swift run openclaw-mac connect --json
swift run openclaw-mac discover --timeout 3000 --json
```

`connect` akceptuje `--url`, `--token`, `--timeout` i `--json`. `discover`
akceptuje `--timeout`, `--json` i `--include-local`. Porównaj wynik wykrywania
z `openclaw gateway discover --json`, gdy musisz oddzielić wykrywanie CLI
od problemów z połączeniem po stronie aplikacji.

## Test smoke

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw --version

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

Następnie:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000
```

## Powiązane

* [aplikacja macOS](/pl/platforms/macos)
* [runbook Gateway](/pl/gateway)