OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Platforms overview

Aplicativo para Linux

O Gateway é totalmente compatível com Linux. Node é o runtime recomendado; Bun não é recomendado (devido a problemas conhecidos com WhatsApp/Telegram).

Ainda não há um aplicativo complementar nativo para Linux. Contribuições são bem-vindas.

Caminho rápido (VPS)

  1. Instale o Node 24 (recomendado) ou o Node 22.19+ (LTS, ainda compatível).
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. No seu laptop: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Abra http://127.0.0.1:18789/ e autentique-se com o segredo compartilhado configurado (token por padrão; senha se gateway.auth.mode for "password").

Guia completo do servidor: Servidor Linux. Exemplo de VPS passo a passo: exe.dev.

Instalação

Serviço do Gateway (systemd)

Instale com um destes comandos:

bash
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # selecione "Serviço do Gateway" quando solicitado

Repare ou migre uma instalação existente:

bash
openclaw doctor

Por padrão, openclaw gateway install gera uma unidade de usuário do systemd. As orientações completas sobre o serviço, incluindo a variante de unidade em nível de sistema para hosts compartilhados ou sempre ativos, estão no guia operacional do Gateway.

Crie uma unidade manualmente apenas para uma configuração personalizada. Exemplo mínimo de unidade de usuário (~/.config/systemd/user/openclaw-gateway[-<profile>].service):

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

Ative-a:

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

Pressão de memória e encerramentos por OOM

No Linux, o kernel escolhe uma vítima de OOM quando um host, uma VM ou o cgroup de um contêiner fica sem memória. O Gateway é uma vítima inadequada porque gerencia sessões de longa duração e conexões de canais; por isso, o OpenClaw prioriza o encerramento de processos filhos transitórios sempre que possível.

Para inicializações elegíveis de processos filhos no Linux, o OpenClaw envolve o comando em um pequeno adaptador /bin/sh que eleva o oom_score_adj do próprio processo filho para 1000 e então executa o comando real com exec. Isso não exige privilégios: um processo sempre pode aumentar sua própria pontuação de OOM.

Superfícies de processos filhos abrangidas:

  • Processos filhos de comandos gerenciados pelo supervisor
  • Processos filhos de shell PTY
  • Processos filhos de servidores MCP via stdio
  • Processos de navegador/Chrome iniciados pelo OpenClaw (por meio do runtime de processos do SDK de plugins)

O adaptador é exclusivo do Linux e é ignorado quando /bin/sh não está disponível ou quando o ambiente do processo filho define OPENCLAW_CHILD_OOM_SCORE_ADJ como 0, false, no ou off.

Verifique um processo filho:

bash
cat /proc/<child-pid>/oom_score_adj

O valor esperado para os processos filhos abrangidos é 1000; o próprio processo do Gateway mantém sua pontuação normal (geralmente 0).

A opção OOMPolicy=continue da unidade systemd mantém o serviço do Gateway ativo quando um processo filho transitório é selecionado pelo encerrador de OOM, em vez de marcar toda a unidade como falha e reiniciar todos os canais; o processo filho ou a sessão que falhou relata seu próprio erro.

Isso não substitui o ajuste normal de memória. Se uma VPS ou um contêiner encerrar processos filhos repetidamente, aumente o limite de memória, reduza a simultaneidade ou adicione controles de recursos mais rigorosos (MemoryMax= do systemd, limites de memória do contêiner).

Relacionados

Was this useful?
On this page

On this page