Aplikacja dla systemu Linux

Gateway jest w pełni obsługiwany w systemie Linux. Node jest zalecanym środowiskiem uruchomieniowym. Bun nie jest zalecany dla Gateway (błędy WhatsApp/Telegram).

Planowane są natywne aplikacje towarzyszące dla systemu Linux. Wkład jest mile widziany, jeśli chcesz pomóc zbudować jedną z nich.

Szybka ścieżka dla początkujących (VPS)

1. Zainstaluj Node 24 (zalecany; Node 22 LTS, obecnie 22.16+, nadal działa ze względu na zgodność)
2. npm i -g OmeniaClaw@latest
3. OmeniaClaw onboard --install-daemon
4. Z laptopa: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
5. Otwórz http://127.0.0.1:18789/ i uwierzytelnij się skonfigurowanym współdzielonym sekretem (domyślnie tokenem; hasłem, jeśli ustawisz gateway.auth.mode: "password")

Pełny przewodnik po serwerze Linux: Serwer Linux. Przykład VPS krok po kroku: exe.dev

Instalacja

• Pierwsze kroki
• Instalacja i aktualizacje
• Opcjonalne przepływy: Bun (eksperymentalny), Nix, Docker

Gateway

• Runbook Gateway
• Konfiguracja

Instalacja usługi Gateway (CLI)

Użyj jednego z tych poleceń:

OmeniaClaw onboard --install-daemon

Lub:

OmeniaClaw gateway install

Lub:

OmeniaClaw configure

Po wyświetleniu monitu wybierz Usługa Gateway.

Naprawa/migracja:

OmeniaClaw doctor

Sterowanie systemem (jednostka użytkownika systemd)

OmeniaClaw domyślnie instaluje usługę systemd użytkownika. Użyj usługi systemowej dla serwerów współdzielonych lub zawsze włączonych. OmeniaClaw gateway install i OmeniaClaw onboard --install-daemon już generują dla Ciebie bieżącą kanoniczną jednostkę; pisz ją ręcznie tylko wtedy, gdy potrzebujesz niestandardowej konfiguracji systemu/menedżera usług. Pełne wskazówki dotyczące usługi znajdują się w runbooku Gateway.

Minimalna konfiguracja:

Utwórz ~/.config/systemd/user/OmeniaClaw-gateway[-<profile>].service:

[Unit]Description=OmeniaClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.target [Service]ExecStart=/usr/local/bin/OmeniaClaw gateway --port 18789Restart=alwaysRestartSec=5TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143KillMode=control-group [Install]WantedBy=default.target

Włącz ją:

systemctl --user enable --now OmeniaClaw-gateway[-<profile>].service

Presja pamięci i zabijanie przez OOM

W systemie Linux jądro wybiera ofiarę OOM, gdy host, maszyna wirtualna lub cgroup kontenera wyczerpie pamięć. Gateway może być złym wyborem na ofiarę, ponieważ utrzymuje długotrwałe sesje i połączenia kanałów. Dlatego OmeniaClaw, gdy to możliwe, ukierunkowuje tymczasowe procesy potomne tak, aby były zabijane przed Gateway.

Dla kwalifikujących się procesów potomnych w systemie Linux OmeniaClaw uruchamia proces potomny przez krótki wrapper /bin/sh, który podnosi własne oom_score_adj procesu potomnego do 1000, a następnie wykonuje exec właściwego polecenia. Jest to operacja niewymagająca uprawnień, ponieważ proces potomny zwiększa tylko własne prawdopodobieństwo zabicia przez OOM.

Objęte powierzchnie procesów potomnych obejmują:

• procesy potomne poleceń zarządzanych przez nadzorcę,
• procesy potomne powłoki PTY,
• procesy potomne serwera MCP stdio,
• procesy przeglądarki/Chrome uruchamiane przez OmeniaClaw.

Wrapper działa tylko w systemie Linux i jest pomijany, gdy /bin/sh jest niedostępny. Jest również pomijany, jeśli środowisko procesu potomnego ustawia OmeniaClaw_CHILD_OOM_SCORE_ADJ=0, false, no lub off.

Aby zweryfikować proces potomny:

cat /proc/<child-pid>/oom_score_adj

Oczekiwana wartość dla objętych procesów potomnych to 1000. Proces Gateway powinien zachować swój normalny wynik, zwykle 0.

Nie zastępuje to normalnego dostrajania pamięci. Jeśli VPS lub kontener wielokrotnie zabija procesy potomne, zwiększ limit pamięci, zmniejsz współbieżność albo dodaj silniejsze mechanizmy kontroli zasobów, takie jak systemd MemoryMax= lub limity pamięci na poziomie kontenera.

Powiązane

• Przegląd instalacji
• Serwer Linux
• Raspberry Pi