English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Platforms overview

App Linux

Gateway è completamente supportato su Linux. Node è il runtime consigliato. Bun non è consigliato per il Gateway (bug di WhatsApp/Telegram).

Sono previste app companion native per Linux. I contributi sono benvenuti se vuoi aiutare a realizzarne una.

Percorso rapido per principianti (VPS)

  1. Installa Node 24 (consigliato; Node 22 LTS, attualmente 22.16+, funziona ancora per compatibilità)
  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 hai impostato gateway.auth.mode: "password")

Guida completa al server Linux: Server Linux. Esempio VPS passo per passo: exe.dev

Installazione

Gateway

Installazione del servizio Gateway (CLI)

Usa uno di questi:

openclaw onboard --install-daemon

Oppure:

openclaw gateway install

Oppure:

openclaw configure

Seleziona Servizio Gateway quando richiesto.

Ripara/migra:

openclaw doctor

Controllo di sistema (unità utente systemd)

OpenClaw installa per impostazione predefinita un servizio systemd utente. 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 corrente; scrivine una a mano solo quando hai bisogno di una configurazione personalizzata di sistema/gestore servizi. La guida completa al servizio si trova nel runbook del Gateway.

Configurazione minima:

Crea ~/.config/systemd/user/openclaw-gateway[-<profile>].service:

[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
KillMode=control-group

[Install]
WantedBy=default.target

Abilitalo:

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

Pressione sulla memoria e terminazioni OOM

Su Linux, il kernel sceglie una vittima OOM quando un cgroup di host, VM o container esaurisce la memoria. Il Gateway può essere una vittima sfavorevole perché gestisce sessioni e connessioni di canale di lunga durata. OpenClaw quindi indirizza, quando possibile, i processi figlio transitori a essere terminati prima del Gateway.

Per gli avvii di processi figlio Linux idonei, OpenClaw avvia il figlio tramite un breve wrapper /bin/sh che aumenta l'oom_score_adj del figlio stesso a 1000, quindi esegue con exec il comando reale. Questa è un'operazione senza privilegi perché il figlio aumenta solo la propria probabilità di terminazione OOM.

Le superfici dei processi figlio coperte includono:

  • processi figlio di comandi gestiti dal supervisore,
  • processi figlio della shell PTY,
  • processi figlio di server stdio MCP,
  • processi browser/Chrome avviati da OpenClaw.

Il wrapper è disponibile solo su Linux e viene ignorato quando /bin/sh non è disponibile. Viene ignorato 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_adj

Il valore previsto per i processi figlio coperti è 1000. Il processo Gateway dovrebbe mantenere il suo punteggio normale, di solito 0.

Questo non sostituisce la normale regolazione della memoria. Se un VPS o container termina ripetutamente i processi figlio, 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.

Correlati