OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Platforms overview

Linux-app

De Gateway wordt volledig ondersteund op Linux. Node is de aanbevolen runtime; Bun wordt niet aanbevolen (bekende problemen met WhatsApp/Telegram).

Er is nog geen native Linux-begeleidende app. Bijdragen zijn welkom.

Snelle route (VPS)

  1. Installeer Node 24 (aanbevolen) of Node 22.19+ (LTS, nog steeds ondersteund).
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. Vanaf uw laptop: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Open http://127.0.0.1:18789/ en verifieer uw identiteit met het geconfigureerde gedeelde geheim (standaard een token; een wachtwoord als gateway.auth.mode op "password" staat).

Volledige serverhandleiding: Linux-server. Stapsgewijs VPS-voorbeeld: exe.dev.

Installatie

Gateway-service (systemd)

Installeer met een van de volgende opdrachten:

bash
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # selecteer "Gateway-service" wanneer daarom wordt gevraagd

Herstel of migreer een bestaande installatie:

bash
openclaw doctor

openclaw gateway install genereert standaard een systemd-gebruikersunit. Volledige service-instructies, waaronder de variant op systeemniveau voor gedeelde hosts of hosts die permanent actief zijn, staan in het Gateway-draaiboek.

Schrijf alleen handmatig een unit voor een aangepaste configuratie. Minimaal voorbeeld van een gebruikersunit (~/.config/systemd/user/openclaw-gateway[-<profile>].service):

ini
[Unit]Description=OpenClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.targetStartLimitBurst=5StartLimitIntervalSec=60 [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5RestartPreventExitStatus=78TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.target

Schakel deze in:

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

Geheugendruk en beëindiging door OOM

Op Linux kiest de kernel een OOM-slachtoffer wanneer het geheugen van een host, VM of container-cgroup opraakt. De Gateway is een ongeschikt slachtoffer, omdat deze langdurige sessies en kanaalverbindingen beheert. Daarom zorgt OpenClaw er waar mogelijk voor dat tijdelijke onderliggende processen als eerste worden beëindigd.

Voor geschikte onderliggende Linux-processen verpakt OpenClaw de opdracht in een korte /bin/sh-shim die de eigen oom_score_adj van het onderliggende proces verhoogt naar 1000 en vervolgens met exec de daadwerkelijke opdracht uitvoert. Hiervoor zijn geen verhoogde bevoegdheden nodig: een proces mag altijd zijn eigen OOM-score verhogen.

Dit geldt voor de volgende onderliggende processen:

  • Door de supervisor beheerde opdrachtprocessen
  • Onderliggende PTY-shellprocessen
  • Onderliggende MCP-stdio-serverprocessen
  • Door OpenClaw gestarte browser-/Chrome-processen (via de procesruntime van de Plugin-SDK)

De wrapper wordt alleen op Linux gebruikt en wordt overgeslagen wanneer /bin/sh niet beschikbaar is, of wanneer de omgeving van het onderliggende proces OPENCLAW_CHILD_OOM_SCORE_ADJ instelt op 0, false, no of off.

Controleer een onderliggend proces:

bash
cat /proc/<child-pid>/oom_score_adj

De verwachte waarde voor processen waarop dit van toepassing is, is 1000; het Gateway-proces zelf behoudt zijn normale score (doorgaans 0).

Dankzij OOMPolicy=continue in de systemd-unit blijft de Gateway-service actief wanneer de OOM-killer een tijdelijk onderliggend proces selecteert. Zo wordt niet de hele unit als mislukt gemarkeerd en worden niet alle kanalen opnieuw gestart; het mislukte onderliggende proces of de mislukte sessie rapporteert een eigen fout.

Dit vervangt normale geheugenafstemming niet. Als een VPS of container herhaaldelijk onderliggende processen beëindigt, verhoog dan de geheugenlimiet, verlaag de gelijktijdigheid of voeg strengere resourcebeperkingen toe (systemd MemoryMax=, containergeheugenlimieten).

Gerelateerd

Was this useful?
On this page

On this page