Naar hoofdinhoud gaan
De Gateway wordt volledig ondersteund op Linux. Node is de aanbevolen runtime. Bun wordt niet aanbevolen voor de Gateway (WhatsApp/Telegram-bugs). Native Linux-begeleidende apps zijn gepland. Bijdragen zijn welkom als je wilt helpen er een te bouwen.

​
Snel pad voor beginners (VPS)

  1. Installeer Node 24 (aanbevolen; Node 22 LTS, momenteel 22.19+, werkt nog steeds voor compatibiliteit)
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. Vanaf je laptop: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Open http://127.0.0.1:18789/ en authenticeer met het geconfigureerde gedeelde geheim (standaard token; wachtwoord als je gateway.auth.mode: "password" hebt ingesteld)
Volledige Linux-serverhandleiding: Linux-server. Stapsgewijs VPS-voorbeeld: exe.dev

​
Installeren

​
Gateway

​
Gateway-service installeren (CLI)

Gebruik een van deze: 
openclaw onboard --install-daemon
Of: 
openclaw gateway install
Of: 
openclaw configure
Selecteer Gateway-service wanneer daarom wordt gevraagd. Repareren/migreren: 
openclaw doctor

​
Systeembeheer (systemd-gebruikerseenheid)

OpenClaw installeert standaard een systemd-service voor de gebruiker. Gebruik een systeemservice voor gedeelde of altijd actieve servers. openclaw gateway install en openclaw onboard --install-daemon genereren al de huidige canonieke eenheid voor je; schrijf er alleen handmatig een wanneer je een aangepaste system-/servicemanager- configuratie nodig hebt. De volledige servicerichtlijnen staan in het Gateway-runbook. Minimale configuratie: Maak ~/.config/systemd/user/openclaw-gateway[-<profile>].service aan: 
[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
OOMPolicy=continue
KillMode=control-group

[Install]
WantedBy=default.target
Schakel deze in: 
systemctl --user enable --now openclaw-gateway[-<profile>].service

​
Geheugendruk en OOM-kills

Op Linux kiest de kernel een OOM-slachtoffer wanneer een host-, VM- of container-cgroup zonder geheugen komt te zitten. De Gateway kan een ongunstig slachtoffer zijn omdat deze langlevende sessies en kanaalverbindingen bezit. OpenClaw zorgt er daarom, waar mogelijk, voor dat tijdelijke child- processen eerder worden beëindigd dan de Gateway. Voor geschikte Linux-childprocessen start OpenClaw het childproces via een korte /bin/sh-wrapper die de eigen oom_score_adj van het childproces verhoogt naar 1000, en daarna de echte opdracht met exec uitvoert. Dit is een niet-geprivilegieerde bewerking, omdat het childproces alleen zijn eigen kans op een OOM-kill verhoogt. Gedekte childprocess-oppervlakken omvatten:
  • door supervisor beheerde command-childprocessen,
  • PTY-shell-childprocessen,
  • MCP stdio-server-childprocessen,
  • door OpenClaw gestarte browser-/Chrome-processen.
De wrapper is alleen voor Linux en wordt overgeslagen wanneer /bin/sh niet beschikbaar is. Deze wordt ook overgeslagen als de child-env OPENCLAW_CHILD_OOM_SCORE_ADJ=0, false, no of off instelt. Een childproces verifiëren: 
cat /proc/<child-pid>/oom_score_adj
De verwachte waarde voor gedekte childprocessen is 1000. Het Gateway-proces moet zijn normale score behouden, meestal 0. De aanbevolen systemd-eenheid stelt ook OOMPolicy=continue in. Hierdoor blijft de Gateway-eenheid actief wanneer een tijdelijk childproces door de OOM-killer wordt geselecteerd; de childopdracht/-sessie kan mislukken en de fout rapporteren zonder dat systemd de hele gatewayservice als mislukt markeert en alle kanalen opnieuw start. Dit vervangt normale geheugentuning niet. Als een VPS of container herhaaldelijk childprocessen beëindigt, verhoog dan de geheugenlimiet, verminder concurrency of voeg sterkere resource-controls toe, zoals systemd MemoryMax= of geheugenlimieten op containerniveau.

​
Gerelateerd