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

Platforms overview

App Linux

Il Gateway è completamente supportato su Linux. Node è il runtime consigliato; Bun non è consigliato (problemi noti con WhatsApp/Telegram).

Non è ancora disponibile un'app complementare nativa per Linux. I contributi sono benvenuti.

Percorso rapido (VPS)

  1. Installa Node 24 (consigliato) o Node 22.19+ (LTS, ancora supportato).
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. Dal tuo portatile: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Apri http://127.0.0.1:18789/ e autenticati con il segreto condiviso configurato (token per impostazione predefinita; password se gateway.auth.mode è "password").

Guida completa per il server: Server Linux. Esempio dettagliato per VPS: exe.dev.

Installazione

Servizio Gateway (systemd)

Installa con uno dei seguenti comandi:

bash
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # seleziona "Servizio Gateway" quando richiesto

Ripara o migra un'installazione esistente:

bash
openclaw doctor

Per impostazione predefinita, openclaw gateway install genera un'unità systemd utente. Le indicazioni complete sul servizio, inclusa la variante dell'unità a livello di sistema per host condivisi o sempre attivi, sono disponibili nel manuale operativo del Gateway.

Scrivi manualmente un'unità solo per una configurazione personalizzata. Esempio minimo di unità utente (~/.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

Abilitala:

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

Pressione sulla memoria e terminazioni OOM

Su Linux, il kernel seleziona una vittima OOM quando un host, una VM o un cgroup di un container esaurisce la memoria. Il Gateway è una vittima poco adatta perché gestisce sessioni e connessioni ai canali di lunga durata, quindi OpenClaw favorisce, quando possibile, la terminazione preventiva dei processi figli temporanei.

Per l'avvio dei processi figli Linux idonei, OpenClaw racchiude il comando in un breve shim /bin/sh che aumenta a 1000 il valore oom_score_adj del processo figlio stesso, quindi esegue il comando reale con exec. Questa operazione non richiede privilegi: un processo può sempre aumentare il proprio punteggio OOM.

Superfici dei processi figli interessate:

  • Processi figli dei comandi gestiti dal supervisore
  • Processi figli della shell PTY
  • Processi figli dei server MCP stdio
  • Processi del browser/Chrome avviati da OpenClaw (tramite il runtime dei processi dell'SDK del plugin)

Il wrapper è specifico per Linux e viene ignorato quando /bin/sh non è disponibile oppure quando l'ambiente del processo figlio imposta OPENCLAW_CHILD_OOM_SCORE_ADJ su 0, false, no o off.

Verifica un processo figlio:

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

Il valore previsto per i processi figli interessati è 1000; il processo Gateway mantiene il proprio punteggio normale (solitamente 0).

L'impostazione OOMPolicy=continue dell'unità systemd mantiene attivo il servizio Gateway quando il terminatore OOM seleziona un processo figlio temporaneo, anziché contrassegnare come non riuscita l'intera unità e riavviare tutti i canali; il processo figlio o la sessione non riusciti segnalano il proprio errore.

Questo comportamento non sostituisce la normale ottimizzazione della memoria. Se un VPS o un container termina ripetutamente i processi figli, aumenta il limite di memoria, riduci la concorrenza o aggiungi controlli delle risorse più rigorosi (MemoryMax= di systemd, limiti di memoria del container).

Risorse correlate

Was this useful?
On this page

On this page