Platforms overview
Aplicativo para Linux
O Gateway é totalmente compatível com Linux. Node é o runtime recomendado. Bun não é recomendado para o Gateway (bugs de WhatsApp/Telegram).
Aplicativos complementares nativos para Linux estão planejados. Contribuições são bem-vindas se você quiser ajudar a criar um.
Caminho rápido para iniciantes (VPS)
- Instale o Node 24 (recomendado; Node 22 LTS, atualmente
22.19+, ainda funciona por compatibilidade) npm i -g openclaw@latestopenclaw onboard --install-daemon- Do seu laptop:
ssh -N -L 18789:127.0.0.1:18789 <user>@<host> - Abra
http://127.0.0.1:18789/e autentique-se com o segredo compartilhado configurado (token por padrão; senha se você definirgateway.auth.mode: "password")
Guia completo de servidor Linux: Servidor Linux. Exemplo passo a passo de VPS: exe.dev
Instalação
- Primeiros passos
- Instalação e atualizações
- Fluxos opcionais: Bun (experimental), Nix, Docker
Gateway
Instalação do serviço Gateway (CLI)
Use um destes:
openclaw onboard --install-daemonOu:
openclaw gateway installOu:
openclaw configureSelecione Serviço Gateway quando solicitado.
Reparar/migrar:
openclaw doctorControle do sistema (unidade de usuário systemd)
O OpenClaw instala um serviço systemd de usuário por padrão. Use um serviço de sistema
para servidores compartilhados ou sempre ativos. openclaw gateway install e
openclaw onboard --install-daemon já renderizam a unidade canônica atual
para você; escreva uma manualmente apenas quando precisar de uma configuração
personalizada de sistema/gerenciador de serviços. A orientação completa do serviço fica no runbook do Gateway.
Configuração mínima:
Crie ~/.config/systemd/user/openclaw-gateway[-<profile>].service:
[Unit]Description=OpenClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.target [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.targetHabilite-o:
systemctl --user enable --now openclaw-gateway[-<profile>].servicePressão de memória e encerramentos por OOM
No Linux, o kernel escolhe uma vítima de OOM quando um host, VM ou cgroup de contêiner fica sem memória. O Gateway pode ser uma vítima ruim porque possui sessões de longa duração e conexões de canal. Por isso, o OpenClaw dá preferência para que processos filhos transitórios sejam encerrados antes do Gateway quando possível.
Para spawns de filhos Linux elegíveis, o OpenClaw inicia o filho por meio de um wrapper
curto de /bin/sh que eleva o oom_score_adj do próprio filho para 1000 e, em seguida,
executa com exec o comando real. Esta é uma operação sem privilégios porque o filho
está apenas aumentando sua própria probabilidade de encerramento por OOM.
As superfícies de processos filhos cobertas incluem:
- filhos de comando gerenciados pelo supervisor,
- filhos de shell PTY,
- filhos de servidor MCP stdio,
- processos de navegador/Chrome iniciados pelo OpenClaw.
O wrapper é exclusivo para Linux e é ignorado quando /bin/sh não está disponível. Ele
também é ignorado se o env do filho definir OPENCLAW_CHILD_OOM_SCORE_ADJ=0, false,
no ou off.
Para verificar um processo filho:
cat /proc/<child-pid>/oom_score_adjO valor esperado para filhos cobertos é 1000. O processo do Gateway deve manter
sua pontuação normal, geralmente 0.
A unidade systemd recomendada também define OOMPolicy=continue. Isso mantém a
unidade do Gateway ativa quando um processo filho transitório é selecionado pelo OOM killer;
o comando/sessão filho pode falhar e relatar seu erro sem que o systemd marque
todo o serviço do gateway como falho e reinicie todos os canais.
Isso não substitui o ajuste normal de memória. Se um VPS ou contêiner encerrar
filhos repetidamente, aumente o limite de memória, reduza a concorrência ou adicione
controles de recursos mais fortes, como MemoryMax= do systemd ou limites de memória no nível do contêiner.
