App de Linux

El Gateway es totalmente compatible con Linux. Node es el tiempo de ejecución recomendado. No se recomienda Bun para el Gateway (errores de WhatsApp/Telegram).

Las aplicaciones complementarias nativas de Linux están planeadas. Las contribuciones son bienvenidas si quieres ayudar a construir una.

Ruta rápida para principiantes (VPS)

Instale Node 24 (recomendado; Node 22 LTS, actualmente 22.19+, todavía funciona por compatibilidad)
npm i -g openclaw@latest
openclaw onboard --install-daemon
Desde tu portátil: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
Abre http://127.0.0.1:18789/ y autentícate con el secreto compartido configurado (token por defecto; contraseña si configuraste gateway.auth.mode: "password")

Guía completa de servidor Linux: Linux Server. Ejemplo paso a paso de VPS: exe.dev

Instalación

Comenzando
Instalación y actualizaciones
Flujos opcionales: Bun (experimental), Nix, Docker

Gateway

Instalación del servicio Gateway (CLI)

Usa uno de estos:

openclaw onboard --install-daemon

openclaw gateway install

openclaw configure

Selecciona Gateway service cuando se te solicite.

Reparar/migrar:

openclaw doctor

Control del sistema (unidad de usuario systemd)

OpenClaw instala un servicio de usuario de systemd por defecto. Usa un servicio de sistema para servidores compartidos o siempre activos. openclaw gateway install y openclaw onboard --install-daemon ya representan la unidad canónica actual para ti; escribe una manualmente solo cuando necesites una configuración personalizada de sistema/gestor de servicios. La guía completa del servicio se encuentra en el Manual del Gateway.

Configuración mínima:

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

Actívalo:

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

Presión de memoria y finalizaciones OOM

En Linux, el núcleo elige una víctima OOM cuando un host, VM o cgroup de contenedor se queda sin memoria. El Gateway puede ser una mala víctima porque posee sesiones y conexiones de canal de larga duración. OpenClaw, por lo tanto, sesga los procesos hijos transitorios para que sean eliminados antes que el Gateway cuando sea posible.

Para los procesos secundarios de Linux elegibles, OpenClaw inicia el proceso secundario a través de un pequeño contenedor /bin/sh que eleva el propio oom_score_adj del proceso secundario a 1000 y luego exec el comando real. Esta es una operación sin privilegios porque el proceso secundario solo está aumentando su propia probabilidad de muerte por OOM.

Las superficies de procesos secundarios cubiertas incluyen:

procesos secundarios de comandos administrados por supervisor,
procesos secundarios de shell PTY,
procesos secundarios del servidor stdio de MCP,
procesos de navegador/Chrome iniciados por OpenClaw.

El contenedor es exclusivo de Linux y se omite cuando /bin/sh no está disponible. También se omite si el entorno del proceso secundario establece OPENCLAW_CHILD_OOM_SCORE_ADJ=0, false, no o off.

Para verificar un proceso secundario:

cat /proc/<child-pid>/oom_score_adj

El valor esperado para los procesos secundarios cubiertos es 1000. El proceso Gateway debe mantener su puntuación normal, generalmente 0.

Esto no reemplaza el ajuste normal de memoria. Si un VPS o contenedor mata repetidamente los procesos secundarios, aumente el límite de memoria, reduzca la concurrencia o agregue controles de recursos más sólidos, como MemoryMax= de systemd o límites de memoria a nivel de contenedor.