Instalar o OpenClaw num VPS

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.
2 Escolha o sistema operativo. O Ubuntu 22.04 LTS é o que tem mais documentação. Se o servidor já existe, veja reinstalar ou mudar o sistema do VPS.
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.
6 Configure a chave de API. Crie a chave no fornecedor do modelo e guarde-a como o projecto indicar, nunca num ficheiro que publique. Veja obter uma chave de API e guardá-la em segurança.
7 Teste com uma tarefa inofensiva. Peça-lhe algo que não toque em nada importante. Só depois ligue um canal de mensagens, como em ligar o OpenClaw a um canal de mensagens.

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

VEJA TAMBÉM

O que é o OpenClaw e o que precisa para o correr

Que sistema operativo escolher para o VPS

Manter o OpenClaw no dia a dia

Política de Suporte

PRODUTO RECOMENDADO

Servidor VPS com acesso root

Recursos só seus, o sistema que escolher, reinstalação quando quiser. desde 456,30 MT/mês (plano de 3 anos, com cupão)

Ver planos
  • 0 Utilizadores acharam útil
Esta resposta foi útil?

Artigos Relacionados

ChatGPT, Claude ou Gemini: que ferramenta de IA para cada tarefa ChatGPT, Claude, Gemini, Copilot, Grok. Aparecem versões novas de mês a mês e a pergunta que nos chega é sempre a mesma:...
Como usar IA no telemóvel, e o que nunca lá escrever Em Moçambique, muita gente trabalha do telemóvel e nem sempre tem computador à mão. As ferramentas de inteligência artif...
Construir um site WordPress com ajuda de IA: o que resulta e o que não Dá para pôr um site WordPress de pé muito mais depressa do que há dois anos, usando ferramentas de inteligência artifici...
Fazer uma página de campanha depressa, com ajuda de IA Uma página de campanha é uma página só, com um objectivo só e uma acção só: deixar o contacto, pedir orçamento, marcar,...
O que é o OpenClaw e o que precisa para o correr O OpenClaw é um agente de IA pessoal, de código aberto, que corre no seu servidor. Em vez de abrir um site de um fornece...
Ligar o OpenClaw a um canal de mensagens Ligar o OpenClaw a um canal de mensagens quer dizer que passa a falar com o agente a partir de uma aplicação de conversa...