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

Platforms overview

Application Linux

Le Gateway est entièrement pris en charge sur Linux. Node est l’environnement d’exécution recommandé. Bun n’est pas recommandé pour le Gateway (bogues WhatsApp/Telegram).

Des applications compagnons Linux natives sont prévues. Les contributions sont les bienvenues si vous voulez aider à en créer une.

Parcours rapide débutant (VPS)

  1. Installez Node 24 (recommandé ; Node 22 LTS, actuellement 22.16+, fonctionne toujours pour la compatibilité)
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. Depuis votre ordinateur portable : ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Ouvrez http://127.0.0.1:18789/ et authentifiez-vous avec le secret partagé configuré (jeton par défaut ; mot de passe si vous définissez gateway.auth.mode: "password")

Guide complet du serveur Linux : Serveur Linux. Exemple VPS étape par étape : exe.dev

Installation

Gateway

Installation du service Gateway (CLI)

Utilisez l’une de ces commandes :

openclaw onboard --install-daemon

Ou :

openclaw gateway install

Ou :

openclaw configure

Sélectionnez Service Gateway lorsque vous y êtes invité.

Réparer/migrer :

openclaw doctor

Contrôle système (unité utilisateur systemd)

OpenClaw installe par défaut un service utilisateur systemd. Utilisez un service système pour les serveurs partagés ou toujours actifs. openclaw gateway install et openclaw onboard --install-daemon génèrent déjà l’unité canonique actuelle pour vous ; rédigez-en une à la main uniquement lorsque vous avez besoin d’une configuration système/gestionnaire de services personnalisée. Les consignes complètes sur les services se trouvent dans le runbook du Gateway.

Configuration minimale :

Créez ~/.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

Activez-la :

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

Pression mémoire et arrêts OOM

Sous Linux, le noyau choisit une victime OOM lorsqu’un hôte, une VM ou un cgroup de conteneur manque de mémoire. Le Gateway peut être une mauvaise victime, car il possède des sessions durables et des connexions de canaux. OpenClaw privilégie donc l’arrêt des processus enfants transitoires avant celui du Gateway lorsque c’est possible.

Pour les lancements de processus enfants Linux éligibles, OpenClaw démarre l’enfant au moyen d’un court wrapper /bin/sh qui augmente le oom_score_adj propre à l’enfant à 1000, puis exécute la vraie commande avec exec. Il s’agit d’une opération non privilégiée, car l’enfant ne fait qu’augmenter sa propre probabilité d’arrêt OOM.

Les surfaces de processus enfants couvertes incluent :

  • les processus enfants de commandes gérés par le superviseur,
  • les processus enfants de shells PTY,
  • les processus enfants de serveurs MCP stdio,
  • les processus browser/Chrome lancés par OpenClaw.

Le wrapper est propre à Linux et est ignoré lorsque /bin/sh n’est pas disponible. Il est également ignoré si l’environnement de l’enfant définit OPENCLAW_CHILD_OOM_SCORE_ADJ=0, false, no ou off.

Pour vérifier un processus enfant :

cat /proc/<child-pid>/oom_score_adj

La valeur attendue pour les enfants couverts est 1000. Le processus Gateway doit conserver son score normal, généralement 0.

Cela ne remplace pas le réglage normal de la mémoire. Si un VPS ou un conteneur arrête régulièrement des enfants, augmentez la limite de mémoire, réduisez la concurrence ou ajoutez des contrôles de ressources plus stricts, comme MemoryMax= de systemd ou des limites de mémoire au niveau du conteneur.

Associés