Aplicación para Linux

Gateway es totalmente compatible con Linux y requiere Node. Bun aún puede usarse como instalador de dependencias o ejecutor de scripts de paquetes, pero no puede ejecutar OpenClaw porque no proporciona node:sqlite.

Aplicación complementaria de escritorio

La aplicación complementaria de OpenClaw para Linux es una aplicación de escritorio Tauri para un Gateway local. Esta:

• instala la CLI de OpenClaw y el entorno de ejecución de Node administrado cuando no están disponibles
• se conecta a un Gateway en buen estado antes de intentar cambiar el servicio
• delega las operaciones de instalación, inicio, detención y reinicio al servicio de usuario de systemd administrado por la CLI
• abre la interfaz de control servida por Gateway con su URL de autenticación resuelta
• permanece disponible en la bandeja del sistema cuando se cierra su ventana

Las versiones estables compiladas desde main incluyen paquetes .deb y AppImage como recursos en la versión de GitHub de la etiqueta, denominados OpenClaw-<version>-amd64.deb y OpenClaw-<version>-amd64.AppImage, con un archivo de suma de comprobación SHA256SUMS.linux-app.txt junto a ellos. Descargue el .deb e instálelo con sudo apt install ./OpenClaw-<version>-amd64.deb, o marque el AppImage como ejecutable y ejecútelo directamente. El entorno de ejecución de AppImage necesita FUSE 2 (sudo apt install libfuse2, o libfuse2t64 en Ubuntu 24.04+); sin este, ejecute el AppImage con APPIMAGE_EXTRACT_AND_RUN=1.

También puede compilar los mismos paquetes desde una copia de trabajo del código fuente:

cd apps/linux/src-tauripnpm dlx @tauri-apps/cli@2.11.4 build --bundles deb,appimage

El flujo de trabajo de CI Linux App carga los mismos paquetes como el artefacto openclaw-linux-companion para las solicitudes de incorporación de cambios que modifican la aplicación y para las ejecuciones manuales. Consulte apps/linux/README.md en el repositorio para conocer las dependencias de compilación de Linux y los comandos de desarrollo.

Alternativa mediante CLI y SSH

La CLI sigue siendo la opción más sencilla para un servidor sin interfaz gráfica, un VPS o un Gateway remoto:

1. Instale Node 24.15+ (recomendado), Node 22.22.3+ (LTS) o Node 25.9+.
2. npm i -g openclaw@latest
3. openclaw onboard --install-daemon
4. Desde su portátil: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
5. Abra http://127.0.0.1:18789/ y autentíquese con el secreto compartido configurado (token de forma predeterminada; contraseña si gateway.auth.mode es "password").

Guía completa del servidor: Servidor Linux. Ejemplo paso a paso de un VPS: exe.dev.

Capacidades de Node

El plugin de Node para Linux incluido proporciona a la CLI capacidades de dispositivo de servicio openclaw node sin requerir la aplicación de escritorio. Los comandos solo se anuncian al Gateway cuando su capacidad está habilitada y existe la herramienta local necesaria.

Configure el plugin en openclaw.json:

{  plugins: {    entries: {      "linux-node": {        config: {          notify: { enabled: true },          camera: { enabled: true },          location: { enabled: true },        },      },    },  },}

Reinicie el servicio Node después de cambiar estos ajustes. La disponibilidad se determina una vez por proceso y el anuncio del Node se reconstruye al reiniciar.

Gateway aprueba la superficie de comandos y capacidades del Node por separado del emparejamiento del dispositivo. En el primer inicio, o después de habilitar más capacidades, apruebe la superficie pendiente:

openclaw nodes pendingopenclaw nodes approve <requestId>

Un Node puede estar conectado y emparejado con el dispositivo mientras sus valores efectivos de caps y commands permanecen vacíos hasta que finalice esta aprobación.

Los dispositivos de cámara deben ser legibles por el usuario del servicio, normalmente mediante el grupo video. Los clips de cámara usan la fuente predeterminada de PulseAudio o PipeWire cuando includeAudio es true; el audio del micrófono solo existe como esa pista del clip, no como un comando independiente. La ubicación requiere que la política de GeoClue del host permita al usuario del servicio Node.

camera.snap y camera.clip también requieren habilitación explícita en Gateway mediante gateway.nodes.allowCommands. Consulte Captura de cámara y Comando de ubicación para conocer las cargas útiles, los límites y los errores.

Instalación

• Primeros pasos
• Instalación y actualizaciones
• Opcional: Flujo de trabajo de paquetes con Bun, Nix, Docker

Servicio Gateway (systemd)

Instálelo con una de estas opciones:

openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # seleccione "Servicio Gateway" cuando se le solicite

Repare o migre una instalación existente:

openclaw doctor

openclaw gateway install genera de forma predeterminada una unidad de usuario de systemd. La guía completa del servicio, incluida la variante de unidad de nivel de sistema para hosts compartidos o siempre activos, se encuentra en el manual operativo de Gateway.

Escriba una unidad manualmente solo para una configuración personalizada. Ejemplo mínimo de unidad de usuario (~/.config/systemd/user/openclaw-gateway[-<profile>].service):

[Unit]Description=OpenClaw Gateway (perfil: <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

Habilítela:

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

Presión de memoria y terminaciones por OOM

En Linux, el kernel elige una víctima de OOM cuando un host, una máquina virtual o un cgroup de contenedor se queda sin memoria. Gateway es una mala víctima porque mantiene sesiones y conexiones de canales de larga duración, por lo que OpenClaw prioriza, cuando es posible, la terminación de los procesos secundarios transitorios.

Para los procesos secundarios de Linux aptos, OpenClaw encapsula el comando en un breve adaptador /bin/sh que aumenta el valor oom_score_adj del propio proceso secundario a 1000 y, a continuación, ejecuta mediante exec el comando real. Esto no requiere privilegios: un proceso siempre puede aumentar su propia puntuación de OOM.

Superficies de procesos secundarios cubiertas:

• Procesos secundarios de comandos administrados por el supervisor
• Procesos secundarios de shell PTY
• Procesos secundarios de servidores stdio de MCP
• Procesos de navegador/Chrome iniciados por OpenClaw (mediante el entorno de ejecución de procesos del SDK del plugin)

El encapsulador es exclusivo de Linux y se omite cuando /bin/sh no está disponible, o cuando el entorno del proceso secundario establece OPENCLAW_CHILD_OOM_SCORE_ADJ en 0, false, no o off.

Verifique un proceso secundario:

cat /proc/<child-pid>/oom_score_adj

El valor esperado para los procesos secundarios cubiertos es 1000; el propio proceso de Gateway conserva su puntuación normal (normalmente 0).

El valor OOMPolicy=continue de la unidad de systemd mantiene activo el servicio Gateway cuando el eliminador de OOM selecciona un proceso secundario transitorio, en lugar de marcar como fallida toda la unidad y reiniciar todos los canales; el proceso secundario o la sesión que ha fallado informa de su propio error.

Esto no sustituye al ajuste normal de la memoria. Si un VPS o contenedor termina procesos secundarios repetidamente, aumente el límite de memoria, reduzca la concurrencia o añada controles de recursos más estrictos (MemoryMax= de systemd, límites de memoria del contenedor).

Contenido relacionado

• Descripción general de la instalación
• Servidor Linux
• Raspberry Pi
• Manual operativo de Gateway
• Configuración de Gateway