Instalar o OpenClaw num VPS resume-se a quatro coisas: um servidor com memória suficiente, uma versão de Node.js à altura, um utilizador próprio e o procedimento de instalação da documentação oficial. Este artigo trata de tudo menos do comando de instalação, de propósito: o comando e as versões actuais mudam, e só a documentação oficial do projecto os mantém certos.
O OpenClaw é um programa de terceiros. A instalação e a manutenção são suas, como em qualquer VPS não gerido (veja até onde vai o nosso suporte). O que fazemos é entregar-lhe o servidor.
Passo a passo
| 1 |
Escolha um servidor que chegue. A documentação aponta para 2 vCPU e 4 GB de RAM como ponto de partida para testes. Um VPS de 1 GB falha na instalação por falta de memória. As especificações dos nossos planos estão em VPS e Cloud.
|
|
| 3 |
Entre por SSH e crie um utilizador próprio. Use o root só para preparar a máquina. Crie um utilizador normal para correr o OpenClaw (no Ubuntu, o comando é adduser). Os primeiros passos estão em primeiros passos com o seu VPS.
|
|
| 4 |
Veja a versão do Node.js. Corra node --version. A documentação pede 22.14 no mínimo e recomenda a 24. Muitas imagens de VPS trazem a 18 ou a 20, e nesse caso tem de actualizar. O procedimento de instalação do projecto pode tratar disto por si: confirme na documentação.
|
|
| 5 |
Siga o procedimento de instalação oficial. Abra a documentação do OpenClaw, copie dali o comando e as opções da versão actual e execute-os com o utilizador próprio. Não use comandos que tenha visto num fórum ou num vídeo antigo.
|
|
Quando a instalação falha
| Sintoma |
Causa provável |
O que fazer |
| A instalação morre a meio, sem erro claro |
Falta de memória |
Veja free -h. Num VPS de 1 GB, mude para um plano maior ou, no mínimo, ligue memória de troca (swap) e tente de novo. |
| Erro a dizer que a versão do Node é antiga |
A imagem trazia o Node 18 ou 20 |
Actualize o Node para a versão pedida pela documentação e repita. |
| Falha a descarregar |
Sem acesso à internet, ou DNS do servidor |
Teste com ping e curl a um endereço conhecido. Veja erros comuns de VPS e Cloud. |
| Funciona no SSH e pára ao fechar a sessão |
O processo está preso ao terminal |
Corra-o como serviço, como a documentação indicar. A ideia geral vê-se em manter uma aplicação Node a correr. |
|
Não instale como root permanente só porque é mais fácil. O OpenClaw executa comandos e lê ficheiros: com root, um erro dele é um erro da máquina inteira. Leia a segurança do OpenClaw.
|
|
Antes de instalar, tire uma cópia (snapshot) ou guarde os ficheiros do servidor. Se algo correr mal, volta atrás em minutos. Veja cópias de um VPS.
|
|
Problema no servidor em si (acesso, rede, sistema)? Abra um pedido e dizemos-lhe o que vemos do nosso lado.
Abrir um pedido de suporte
|
Nos nossos planos
Do nosso lado, o plano tem de dar pelo menos 2 vCPU e 4 GB de RAM para um ensaio. O VPS1 e o Cloud1 (2 GB de RAM) ficam abaixo disso, por isso escolha um degrau acima; todos os degraus estão listados nas páginas de VPS e de Cloud, até 32 vCPU e 64 GB. Os sistemas operativos disponíveis aparecem na altura da encomenda, por isso escolha aí; o Ubuntu é o que o artigo sugere. Depois de entrar por SSH, vê o que o servidor tem com cat /etc/os-release, que lhe diz se é o Ubuntu 22.04 LTS ou outra versão antes de instalar o que quer que seja. Se a imagem não for a que quer, o artigo sobre reinstalar ou mudar o sistema do VPS explica o caminho.
PRODUTO RECOMENDADO Servidor VPS com acesso root Recursos só seus, o sistema que escolher, reinstalação quando quiser. desde 504,00 MT/mês (plano de 3 anos, com cupão) Ver planos |
Português
English
