Platforms overview
App Linux
OpenClaw Gateway è pienamente supportato su Linux. Node è il runtime consigliato. Bun non è consigliato per Gateway (bug di WhatsApp/Telegram).
Sono previste app companion native per Linux. I contributi sono benvenuti se vuoi aiutare a crearne una.
Percorso rapido per principianti (VPS)
- Installa Node 24 (consigliato; Node 22 LTS, attualmente
22.19+, funziona ancora per compatibilità) npm i -g openclaw@latestopenclaw onboard --install-daemon- Dal tuo laptop:
ssh -N -L 18789:127.0.0.1:18789 <user>@<host> - Apri
http://127.0.0.1:18789/e autenticati con il segreto condiviso configurato (token per impostazione predefinita; password se hai impostatogateway.auth.mode: "password")
Guida completa al server Linux: Server Linux. Esempio VPS passo per passo: exe.dev
Installazione
- Introduzione
- Installazione e aggiornamenti
- Flussi facoltativi: Bun (sperimentale), Nix, Docker
Gateway
Installazione del servizio Gateway (CLI)
Usa uno di questi:
openclaw onboard --install-daemonOppure:
openclaw gateway installOppure:
openclaw configureSeleziona Servizio Gateway quando richiesto.
Ripara/migra:
openclaw doctorControllo di sistema (unità utente systemd)
OpenClaw installa un servizio utente systemd per impostazione predefinita. Usa un servizio di sistema per server condivisi o sempre attivi. openclaw gateway install e
openclaw onboard --install-daemon generano già per te l'unità canonica attuale;
scrivine una a mano solo quando ti serve una configurazione system/service-manager
personalizzata. La guida completa al servizio si trova nel runbook di Gateway.
Configurazione minima:
Crea ~/.config/systemd/user/openclaw-gateway[-<profile>].service:
[Unit]Description=OpenClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.target [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.targetAbilitala:
systemctl --user enable --now openclaw-gateway[-<profile>].servicePressione sulla memoria e terminazioni OOM
Su Linux, il kernel sceglie una vittima OOM quando un cgroup di host, VM o container esaurisce la memoria. Gateway può essere una cattiva vittima perché possiede sessioni di lunga durata e connessioni di canale. OpenClaw quindi fa in modo, quando possibile, che i processi figli transitori vengano terminati prima di Gateway.
Per gli avvii di processi figli Linux idonei, OpenClaw avvia il figlio tramite un breve
wrapper /bin/sh che porta l'oom_score_adj del figlio a 1000, quindi
esegue con exec il comando reale. Questa è un'operazione senza privilegi perché il figlio sta
solo aumentando la propria probabilità di terminazione OOM.
Le superfici dei processi figli coperte includono:
- figli di comandi gestiti dal supervisore,
- figli di shell PTY,
- figli di server stdio MCP,
- processi browser/Chrome avviati da OpenClaw.
Il wrapper è solo per Linux e viene saltato quando /bin/sh non è disponibile. Viene
saltato anche se l'ambiente del figlio imposta OPENCLAW_CHILD_OOM_SCORE_ADJ=0, false,
no o off.
Per verificare un processo figlio:
cat /proc/<child-pid>/oom_score_adjIl valore atteso per i figli coperti è 1000. Il processo Gateway dovrebbe mantenere
il suo punteggio normale, di solito 0.
L'unità systemd consigliata imposta anche OOMPolicy=continue. Questo mantiene
viva l'unità Gateway quando un processo figlio transitorio viene selezionato dall'OOM killer;
il comando/la sessione figlio può non riuscire e segnalare il proprio errore senza che systemd contrassegni
l'intero servizio gateway come non riuscito e riavvii tutti i canali.
Questo non sostituisce la normale regolazione della memoria. Se un VPS o un container termina ripetutamente
i figli, aumenta il limite di memoria, riduci la concorrenza o aggiungi controlli
delle risorse più forti come MemoryMax= di systemd o limiti di memoria a livello di container.
