Tutoriais de VPS
Tutorial de instalação do OpenClaw em VPS (2026): implantação em servidor cloud Ubuntu, acesso por túnel SSH e erros comuns
Se você quer rodar o OpenClaw em um servidor cloud a longo prazo, o ponto principal não é terminar de digitar os comandos, mas configurar de uma vez o runtime, o serviço em segundo plano, a forma de acesso e o limite de segurança. Este artigo segue o fluxo real de implantação em um VPS Ubuntu e orienta você a concluir a instalação do OpenClaw, a inicialização do daemon, o acesso por túnel SSH, a verificação básica e a solução de erros comuns.

Se você quer o OpenClaw online 24/7, implantá-lo em um VPS costuma ser mais estável do que mantê-lo no computador local.
A documentação oficial já oferece suporte bastante completo para esse caminho: um VPS Linux pode executar diretamente o OpenClaw Gateway e, em seguida, você acessa a interface de controle do seu notebook por meio de um túnel SSH ou outro método controlado. A vantagem é que o workspace, o estado e o serviço em segundo plano ficam no servidor e não são interrompidos quando você fecha o notebook ou quando sua rede local oscila.
Este artigo foi escrito para um VPS Ubuntu comum, com um objetivo bem claro:
- Instalar o OpenClaw em um servidor cloud
- Manter o Gateway rodando de forma permanente como serviço em segundo plano
- Acessar a interface de controle com segurança a partir do navegador local
- Resolver, de passagem, os erros mais comuns durante a instalação
Antes de começar, você precisa pelo menos do seguinte:
- Um VPS Ubuntu
- Um usuário comum que possa fazer login via SSH
- O servidor conseguir acessar a internet normalmente
- Seu computador local também conseguir usar o comando
ssh
De acordo com o FAQ oficial, o requisito mínimo do OpenClaw em um VPS não é alto, mas é recomendável preparar pelo menos uma máquina com 1-2 vCPU / 2GB RAM. Para o sistema, prefira Ubuntu LTS ou uma distribuição baseada em Debian.
Se você só está testando, uma configuração mais simples também consegue iniciar; se depois você for conectar mais canais e rodar mais workspaces, é melhor não deixar a memória tão apertada desde o início.
Primeiro, faça login no servidor:
ssh your-user@your-server-ip
Depois de conectar, faça uma atualização do sistema:
sudo apt update && sudo apt upgrade -y
Em seguida, instale algumas ferramentas básicas:
sudo apt install -y curl git unzip ca-certificates
Esse passo parece comum, mas é importante. Muitas falhas de instalação posteriores, na essência, acontecem porque o sistema está muito antigo, os certificados estão incompletos ou faltam comandos básicos como curl e git.
O OpenClaw recomenda oficialmente o Node 24 atualmente e também é compatível com o Node 22 LTS mais recente. Para um VPS, a forma mais segura é instalar diretamente uma versão mais recente com suporte oficial, em vez de continuar usando o Node possivelmente mais antigo dos repositórios do Ubuntu.
Se a sua máquina ainda não tem Node, verifique primeiro:
node -v
npm -v
Se não estiver instalado, ou a versão for muito antiga, você pode instalar o Node 24 via NodeSource:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
Após a instalação, confirme a versão mais uma vez:
node -v
npm -v
Se aqui aparecer Node 24, você pode continuar.
Se você quer o caminho mais curto, pode executar diretamente o script de instalação oficial:
curl -fsSL https://openclaw.ai/install.sh | bash
Esse método é indicado para quem quer colocar para rodar o quanto antes.
Se você prefere controlar cada etapa, também pode instalar globalmente com npm diretamente:
npm install -g openclaw@latest
Após a instalação, confirme se o comando já está disponível:
openclaw --version
Se aqui o número da versão for exibido normalmente, a instalação da CLI foi bem-sucedida.
O ponto de entrada de inicialização recomendado oficialmente pelo OpenClaw não é montar manualmente um monte de configuração, mas executar diretamente:
openclaw onboard --install-daemon
Esse comando vai orientar você na configuração inicial e, de passagem, instalar o Gateway como serviço em segundo plano.
Você pode entender isso como fazer duas coisas ao mesmo tempo:
- Concluir a primeira configuração do OpenClaw
- Registrar o Gateway como serviço de usuário do systemd, garantindo que ele continue rodando depois que você sair do terminal
Durante esse processo, você normalmente vai encontrar estas entradas principais:
- Porta de escuta do Gateway
- Método de autenticação de acesso
- Shared secret ou token
- Configuração de inicialização do workspace ou do profile
Recomenda-se anotar primeiro o token ou a senha, pois você vai precisar deles ao acessar pelo navegador local mais tarde.
Depois da inicialização, não se apresse em abrir a interface localmente; primeiro confirme o status do serviço no servidor.
Você pode verificar primeiro o processo ou o serviço:
systemctl --user status openclaw-gateway
Se o nome do seu serviço tiver sufixo de profile, também pode ser um nome parecido com este:
systemctl --user status openclaw-gateway-yourprofile
Se você quiser ver os logs:
journalctl --user -u openclaw-gateway -f
Ou o nome de serviço correspondente ao seu próprio profile.
Em condições normais, você deve ver que o Gateway está escutando na porta padrão 18789 e que o status do serviço é running.
Se o fluxo de instalação anterior não instalou automaticamente com sucesso, você também pode executar manualmente mais uma vez:
openclaw gateway install
Ou executar novamente:
openclaw doctor
A documentação oficial também considera doctor como o primeiro ponto de entrada de diagnóstico em cenários de reparo e migração.
Este é o passo mais crítico da implantação em VPS e também o mais fácil de passar despercebido.
Muitas pessoas, assim que instalam o serviço, querem expor diretamente a porta 18789 para a internet pública. Mas a forma recomendada pela documentação oficial é primeiro deixar o Gateway escutando apenas no endereço de loopback local e depois acessar do seu próprio computador por meio de um túnel SSH.
Execute no seu computador local:
ssh -N -L 18789:127.0.0.1:18789 your-user@your-server-ip
O significado deste comando é:
- Encaminhar o seu
127.0.0.1:18789local - Para
127.0.0.1:18789no VPS
Depois, abra no navegador local:
http://127.0.0.1:18789/
Você verá a interface de controle do OpenClaw e então deverá inserir o token ou a senha configurados na etapa openclaw onboard.
As vantagens desse caminho são bem diretas:
- Não é preciso expor a porta de administração diretamente à internet pública
- O limite de segurança é mais claro
- Adequado para uso de longo prazo por indivíduos ou equipes pequenas
Se mais tarde você realmente precisar de um acesso remoto mais permanente, considerar Tailscale ou outras soluções de rede mais completas será mais razoável.
Conseguir abrir a interface de controle não significa que a instalação já esteja totalmente funcional; vale fazer mais uma camada de verificação.
Você pode testar os seguintes comandos no servidor:
openclaw doctor
Se você só quer confirmar se o Gateway consegue iniciar em primeiro plano, também pode executar temporariamente:
openclaw gateway --port 18789 --verbose
Se você já concluiu a configuração relacionada a modelos ou canais, também pode seguir com uma verificação funcional mais avançada, como enviar uma mensagem de teste ou iniciar uma conversa simples com o agente.
Mas, para um tutorial de instalação, com este passo já é suficiente para determinar:
- O ambiente Node está normal
- A CLI do OpenClaw está disponível
- O Gateway foi implantado com sucesso
- É possível acessar com segurança localmente por túnel SSH
Se você só está testando a instalação pela primeira vez, o método Node + npm + onboard acima já é suficiente.
Mas, se você pretende rodar o OpenClaw como serviço permanente de longo prazo em um VPS, o caminho Docker também vale a pena considerar, especialmente nos seguintes casos:
- Você quer uma forma de execução mais unificada
- Você já tem hábitos consolidados de operação com Docker
- Você quer gerenciar com mais clareza os diretórios de dados e o processo de atualização
A documentação oficial já oferece uma solução Docker Compose para o cenário Hetzner, cuja ideia central é persistir estes diretórios:
~/.openclawworkspace- Possivelmente também outros diretórios de cache do runtime
Se mais tarde você for escrever um plano de implantação mais voltado para produção, pode perfeitamente ampliar este artigo em um artigo de "Implantação do OpenClaw com Docker".
Isso normalmente indica que o diretório global de instalação do npm não está no PATH do shell atual, ou que a instalação simplesmente não foi bem-sucedida.
Verifique primeiro:
npm root -g
npm bin -g
Depois confirme se o diretório correspondente já foi adicionado ao PATH.
Se você instalou pelo script de instalação, também é recomendável abrir uma nova sessão de shell e tentar novamente.
Se você vir um erro em tempo de execução, verifique primeiro a versão do Node:
node -v
O OpenClaw recomenda oficialmente o Node 24 atualmente. O Node dos repositórios padrão do Ubuntu costuma ser muito antigo e não é recomendável usá-lo diretamente.
Nesse caso, normalmente vale verificar primeiro 3 coisas:
- Se o Gateway no VPS realmente está rodando
- Se o seu comando de túnel SSH ainda está conectado
- Se a porta foi escrita errado
O problema mais comum não é o OpenClaw não ter iniciado, mas você ter fechado a sessão SSH, o que fez o encaminhamento local deixar de funcionar.
Tecnicamente é possível, mas não é recomendável fazer isso de cara.
Se você não limitou claramente o modo de autenticação, o endereço de escuta e a origem de acesso, é como expor diretamente o plano de administração. Para implantações pessoais, um túnel SSH normalmente já é suficiente.
Se você só executou openclaw gateway --port 18789 em primeiro plano, então, é claro, ele para depois que você sai do shell.
Para rodar a longo prazo, você deve usar:
openclaw onboard --install-daemon
Ou:
openclaw gateway install
Depois use systemctl --user para confirmar o status do serviço.
Se você só quer colocar o OpenClaw para rodar em um VPS, o caminho mais seguro na verdade não é complicado:
- Preparar um VPS Ubuntu
- Instalar o Node 24
- Instalar a CLI do OpenClaw
- Executar
openclaw onboard --install-daemon - Acessar
127.0.0.1:18789por túnel SSH
Esse caminho é mais adequado para a maioria dos usuários individuais do que "expor diretamente a porta pública" e também está mais alinhado com a forma recomendada oficialmente pelo OpenClaw para implantação em VPS.
Se mais tarde você pretende rodar a longo prazo, conectar vários dispositivos ou adicionar mais tarefas de automação, continuar com dockerização, acesso remoto e estratégias de backup será mais estável.
O próximo passo mais prático não é continuar lendo tutoriais, mas colocar o seu próprio VPS para rodar primeiro e depois usar openclaw doctor para fazer uma verificação completa.