Skip to main content
Gateway jest w pełni obsługiwany w systemie Linux. Node jest zalecanym środowiskiem uruchomieniowym; Bun nie jest zalecany (znane problemy z WhatsApp/Telegram). Natywna aplikacja towarzysząca dla systemu Linux nie jest jeszcze dostępna. Zachęcamy do współtworzenia.

​
Szybka ścieżka (VPS)

  1. Zainstaluj Node 24 (zalecany) lub Node 22.19+ (LTS, nadal obsługiwany).
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. Na swoim laptopie uruchom: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Otwórz http://127.0.0.1:18789/ i uwierzytelnij się przy użyciu skonfigurowanego współdzielonego sekretu (domyślnie tokenu; hasła, jeśli gateway.auth.mode ma wartość "password").
Pełny przewodnik po serwerze: Serwer Linux. Przykład konfiguracji VPS krok po kroku: exe.dev.

​
Instalacja

​
Usługa Gateway (systemd)

Zainstaluj przy użyciu jednego z poniższych poleceń:
Napraw lub zmigruj istniejącą instalację:
openclaw gateway install domyślnie generuje jednostkę systemd użytkownika. Pełne wskazówki dotyczące usługi, w tym wariant jednostki na poziomie systemowym dla współdzielonych lub stale działających hostów, znajdują się w podręczniku operacyjnym Gateway. Utwórz jednostkę ręcznie tylko w przypadku konfiguracji niestandardowej. Minimalny przykład jednostki użytkownika (~/.config/systemd/user/openclaw-gateway[-<profile>].service):
Włącz ją:

​
Presja na pamięć i zakończenia procesów przez mechanizm OOM

W systemie Linux jądro wybiera proces do zakończenia przez mechanizm OOM, gdy hostowi, maszynie wirtualnej lub grupie cgroup kontenera zabraknie pamięci. Gateway jest niewłaściwym kandydatem, ponieważ zarządza długotrwałymi sesjami i połączeniami kanałów, dlatego OpenClaw zwiększa prawdopodobieństwo, że w miarę możliwości najpierw zostaną zakończone tymczasowe procesy potomne. W przypadku odpowiednich procesów potomnych uruchamianych w systemie Linux OpenClaw opakowuje polecenie w krótki skrypt pośredniczący /bin/sh, który podnosi wartość oom_score_adj samego procesu potomnego do 1000, a następnie wykonuje rzeczywiste polecenie za pomocą exec. Nie wymaga to podwyższonych uprawnień: proces zawsze może zwiększyć własny wynik OOM. Objęte mechanizmem rodzaje procesów potomnych:
  • Procesy potomne poleceń zarządzane przez nadzorcę
  • Procesy potomne powłoki PTY
  • Procesy potomne serwerów MCP korzystających ze standardowego wejścia i wyjścia
  • Procesy przeglądarki/Chrome uruchamiane przez OpenClaw (za pośrednictwem środowiska uruchomieniowego procesów SDK Pluginu)
Mechanizm opakowujący działa tylko w systemie Linux i jest pomijany, gdy /bin/sh jest niedostępny lub gdy środowisko procesu potomnego ustawia OPENCLAW_CHILD_OOM_SCORE_ADJ na 0, false, no albo off. Sprawdź proces potomny:
Oczekiwana wartość dla objętych procesów potomnych to 1000; sam proces Gateway zachowuje standardową wartość (zwykle 0). Ustawienie OOMPolicy=continue jednostki systemd utrzymuje działanie usługi Gateway, gdy mechanizm OOM wybierze tymczasowy proces potomny, zamiast oznaczać całą jednostkę jako uszkodzoną i ponownie uruchamiać wszystkie kanały; proces potomny lub sesja, które uległy awarii, zgłaszają własny błąd. Nie zastępuje to standardowego dostrajania pamięci. Jeśli VPS lub kontener wielokrotnie kończy procesy potomne, zwiększ limit pamięci, zmniejsz współbieżność lub dodaj bardziej rygorystyczne mechanizmy kontroli zasobów (systemd MemoryMax=, limity pamięci kontenera).

​
Powiązane