Você não precisa de um supercomputador, mas é importante seguir alguns requisitos para ter estabilidade e evitar dor de cabeça na instalação.<\/p>
Confira este checklist do servidor:<\/p>
- \n
- Sistema operacional Linux (Ubuntu 22.04 ou 24.04 funciona muito bem).<\/li>\n\n\n\n
- Acesso administrativo (permissões de root ou sudo).<\/li>\n\n\n\n
- Docker e Docker Compose.<\/li>\n\n\n\n
- Pelo menos 2 GB de RAM (4 GB recomendados para melhor desempenho).<\/li>\n\n\n\n
- Mais de 10 GB de espaço em disco para imagens Docker, dados de aplicativos e logs.<\/li>\n<\/ul>
Para esta configuração, usaremos a hospedagem de OpenClaw da Hostinger<\/a>, porque o Docker Manager facilita bastante o processo. Mas os mesmos princípios valem para qualquer outro provedor de VPS.<\/p>
Se você está começando agora com servidores virtuais privados, veja primeiro como configurar um VPS<\/a>. Siga o passo a passo inicial para garantir que você consegue acessar o servidor via SSH antes de continuar.<\/p>
![\"\"](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/public\")
<\/a><\/figure>2. Verifique se o Docker está disponível no VPS<\/h2>
O Docker é como vamos rodar o OpenClaw. Pense nele como um container que “empacota” tudo o que o OpenClaw precisa em um único lugar. Em vez de instalar dependências manualmente e ajustar configurações uma por uma, o Docker cuida disso. O resultado é uma instalação mais limpa, mais confiável e muito mais fácil de gerenciar.<\/p>
No hPanel da Hostinger, procure pelo Docker Manager<\/strong>. Ele deve mostrar o Docker como instalado (ou oferecer a opção de ativar). Esse é o caminho mais simples.<\/p>
Se você estiver usando outro VPS ou quiser confirmar pelo terminal, conecte via SSH e execute:<\/p>
docker --version
docker compose version<\/pre>Você deve ver o número da versão do Docker e do Docker Compose. Se aparecer “command not found”, significa que o Docker ainda não está instalado.<\/p>
Uma instalação correta do OpenClaw com Docker depende de um ambiente saudável, então se você precisar fazer uma instalação manual, leia nosso tutorial sobre como instalar Docker no Ubuntu<\/a> e depois repita a verificação.<\/p>
Assim que o Docker estiver confirmado e em execução, você seguir para a parte prática de deploy do OpenClaw.<\/p>
3. Clone o repositório do OpenClaw<\/h2>
Agora vem a parte boa. Vamos clonar o repositório do OpenClaw e usar o script oficial de setup com Docker para montar e colocar tudo no ar.<\/p>
Primeiro, você precisa baixar o código do OpenClaw no seu servidor:<\/p>
# Instale o git (se ainda não tiver)
sudo apt install git -y
# Clone o repositório
git clone https:\/\/github.com\/openclaw\/openclaw.git
# Entre na pasta do projeto
cd openclaw<\/pre>Em seguida, execute o script de setup do Docker. O OpenClaw já inclui um script que automatiza praticamente tudo:<\/p>
.\/docker-setup.sh<\/pre>
Esse script é o “pacote completo” para colocar o OpenClaw rodando. Ele faz o seguinte:<\/p>
- \n
- Cria a imagem Docker do OpenClaw localmente (usando o Dockerfile do próprio projeto).<\/li>\n\n\n\n
- Executa o assistente de configuração inicial dentro de um container Docker.<\/li>\n\n\n\n
- Gera um gateway token para acessar a Control UI.<\/li>\n\n\n\n
- Cria os diretórios de configuração necessários.<\/li>\n\n\n\n
- Inicia o gateway do OpenClaw via Docker Compose.<\/li>\n<\/ol>
Todo o processo é automatizado. Diferente de muitos apps em Docker, em que você só baixa uma imagem pronta, o OpenClaw cria a imagem localmente no seu servidor. Isso significa que:<\/p>
- \n
- Você sempre roda exatamente a versão que está no repositório.<\/li>\n\n\n\n
- A primeira build pode levar alguns minutos.<\/li>\n\n\n\n
- As próximas builds ficam mais rápidas graças ao cache de camadas do Docker.<\/li>\n\n\n\n
- Você tem controle total sobre o que entra na imagem.<\/li>\n<\/ul>
4. Configure credenciais e configurações do OpenClaw<\/h2>
O script de setup do Docker abre um assistente interativo de configuração inicial que prepara o OpenClaw para você. É aqui que você define as credenciais do provedor de IA e outras configurações essenciais.<\/p>
Ao executar o script .\/docker-setup.sh<\/strong>, depois que a imagem é criada, o assistente aparece e faz algumas perguntas importantes:<\/p>
Modo gateway:<\/strong><\/p>
- \n
- Local (rodar nesta máquina)<\/li>\n\n\n\n
- Remote (conectar a um gateway existente)<\/li>\n<\/ul>
Escolha Local<\/strong>. Assim, o gateway vai rodar no seu VPS.<\/p>
Método de autenticação:<\/strong><\/p>
Essa é a parte mais importante, porque é onde você informa como o OpenClaw vai acessar os modelos de IA:<\/p>
- \n
- Anthropic API Key (recomendado)<\/li>\n\n\n\n
- OpenAI API Key<\/li>\n\n\n\n
- OAuth (assinatura Claude Pro\/Max)<\/li>\n\n\n\n
- OpenAI Code (assinatura Codex)<\/li>\n<\/ul>
Se você seguir a opção recomendada (Anthropic API Key), o processo é assim: crie uma conta (ou faça login) na Anthropic, vá até a seção de API Keys, gere uma nova chave, copie e cole no assistente.<\/p>
Guarde essa chave com segurança. Qualquer pessoa com acesso a ela pode usar o Claude na sua conta — e o consumo será cobrado de você.<\/p>
Com as outras opções, a lógica é parecida: você pega a chave na plataforma de IA e adiciona no setup. O assistente salva essas credenciais como variáveis de ambiente no Linux<\/a> dentro dos arquivos de configuração.<\/p>
Depois disso, você escolhe o modelo da plataforma selecionada e ajusta as configurações de segurança.<\/p>
Um dos erros mais comuns na configuração do OpenClaw é esquecer a API key. Sem uma chave válida da Anthropic ou da OpenAI, ele simplesmente não funciona. Além disso, tanto a Anthropic quanto a OpenAI exigem um método de pagamento cadastrado para liberar acesso via API — então confirme que sua chave está ativa e com billing configurado.<\/p>
5. Inicie o OpenClaw e confirme que ele está rodando<\/h2>
Depois que o script de setup termina, o OpenClaw já deve estar em execução.<\/p>
Para confirmar que está tudo certo, verifique o status dos containers:<\/p>
# Garanta que você está no diretório do OpenClaw
cd ~\/openclaw
# Veja os containers em execução
docker compose ps<\/pre>Você deverá ver o openclaw-gateway<\/strong> com status “Up” ou “Running”. Outros sinais de que está tudo funcionando incluem:<\/p>
- \n
- Uma mensagem do tipo “OpenClaw initialized”<\/li>\n\n\n\n
- Provedor de modelo conectado (Anthropic\/OpenAI)<\/li>\n\n\n\n
- Nenhum erro de autenticação<\/li>\n<\/ul>
Por outro lado, se aparecer algo como “Invalid API key”, “Authentication failed”, “Connection refused”, ou se o container ficar reiniciando sem parar, então existe algum problema na configuração.<\/p>
Nesse caso, pare por aqui e corrija antes de continuar, checando os logs:<\/p>
docker compose logs openclaw-gateway<\/pre>
Isso é importante para a resolução de problemas. Os logs do OpenClaw mostram exatamente o que o bot está tentando fazer, ajudando você a identificar e resolver o erro com mais rapidez.<\/p>
6. Acesse a interface do OpenClaw<\/h2>
O painel do OpenClaw fica disponível pelo IP do seu VPS na porta 18789:<\/p>
http:\/\/ip-do-seu-vps:18789<\/pre>
Por exemplo: http:\/\/45.123.45.67:18789<\/strong><\/p>
Na primeira vez que você abrir a Control UI, será necessário informar o gateway token gerado durante a configuração. Você pode encontrá-lo com:<\/p>
cat ~\/.clawdbot\/.env | grep CLAWDBOT_GATEWAY_TOKEN<\/pre>
Outra opção é conferir o output do comando .\/docker-setup.sh<\/strong> — ele mostra o token no final do processo.<\/p>
Observação: <\/strong>apesar de o projeto ter sido renomeado para OpenClaw, alguns arquivos e diretórios de configuração ainda usam o nome “clawdbot” (como ~\/.clawdbot\/<\/strong> e CLAWDBOT_GATEWAY_TOKEN)<\/strong>. Isso é normal durante a transição e não afeta o funcionamento.<\/p>
Depois de entrar no painel, vá em Settings → Token (ou você pode ser direcionado automaticamente). Cole o gateway token e clique em Save ou Authenticate.<\/p>
Essa interface é o seu centro de controle. Você não precisa configurar tudo agora — o mais importante é confirmar que consegue acessar e que o OpenClaw aparece como saudável (healthy).<\/p>
Se você não conseguir abrir a interface, tente estes passos de solução de problemas:<\/p>
- \n
- Verifique se o container está em execução: docker compose ps<\/strong><\/li>\n\n\n\n
- Verifique se o seu firewall não está bloqueando a porta.<\/li>\n\n\n\n
- Garanta que você está usando HTTP<\/strong>, não HTTPS<\/li>\n\n\n\n
- Teste o acesso direto no próprio servidor via terminal: curl http:\/\/localhost:18789<\/strong><\/li>\n<\/ul>
7. Conecte um canal de mensagens ao OpenClaw<\/h2>
O painel web que você configurou serve para gerenciamento. Mas a interação com o OpenClaw acontece mesmo por um app de mensagens, onde as conversas com IA rolam no dia a dia.<\/p>
Aqui vamos usar o Telegram porque é bem simples, mas o processo é parecido em outras plataformas.<\/p>
Veja como fazer a configuração do OpenClaw no Telegram:<\/p>
Passo 1: crie um bot no Telegram<\/strong><\/p>
- \n
- Abra o Telegram e procure por @BotFather<\/strong><\/li>\n\n\n\n
- Inicie um bate-papo e envie \/newbot<\/strong><\/li>\n\n\n\n
- Siga as instruções:\n
- \n
- Escolha um nome (por exemplo, Meu Assistente OpenClaw)<\/li>\n\n\n\n
- Escolha um nome de usuário (deve terminar em “bot”, como “myawesomeopenclaw”)<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- O BotFather vai gerar um bot token. Copie esse token.<\/li>\n<\/ol>
Passo 2: adicione o Telegram ao OpenClaw<\/strong><\/p>
No seu servidor, execute:<\/p>
# Garanta que você está no diretório do OpenClaw
cd ~\/openclaw
# Adicione o Telegram usando o token do bot
docker compose exec openclaw-gateway node dist\/index.js providers add --provider telegram --token TOKEN_DO_SEU_BOT<\/pre>Substitua TOKEN_DO_SEU_BOT<\/strong> pelo token que você recebeu do BotFather.<\/p>
Passo 3: ative as permissões necessárias do bot<\/strong><\/p>
No chat do BotFather:<\/p>
- \n
- Envie \/mybots<\/strong><\/li>\n\n\n\n
- Selecione seu bot<\/li>\n\n\n\n
- Vá em Bot Settings → Group Privacy<\/li>\n\n\n\n
- Desative a privacidade de grupo (isso permite que o bot leia mensagens em grupos).<\/li>\n<\/ol>
Passo 4: Comece a conversar<\/strong><\/p>
- \n
- Abra o Telegram e procure pelo seu bot (pelo nome de usuário que você escolheu).<\/li>\n\n\n\n
- Inicie uma conversa<\/li>\n\n\n\n
- Envie uma mensagem para testar.<\/li>\n<\/ol>
Se você configurou o pareamento por DM durante o setup, você vai receber um código de pareamento. No servidor, aprove esse código com:<\/p>
docker compose exec openclaw-gateway node dist\/index.js pairing approve telegram <o-codigo-que-voce-recebeu><\/pre>
Após a aprovação, envie outra mensagem. O OpenClaw deve responder!<\/p>
Se as mensagens não estiverem funcionando na sua configuração do OpenClaw com Telegram:<\/p>
- \n
- Verifique os logs do OpenClaw para encontrar erros.<\/li>\n\n\n\n
- Confirme se as API keys continuam válidas.<\/li>\n\n\n\n
- Veja se o container não reiniciou ou caiu.<\/li>\n\n\n\n
- Garanta que as credenciais da plataforma de mensagens estão corretas.<\/li>\n<\/ul>
Como instalar o OpenClaw na Hostinger<\/strong><\/h2>
Clientes da Hostinger podem pular toda a configuração manual via linha de comando ao instalar o OpenClaw.<\/p>
Nossa equipe criou um template pré-configurado que instala o OpenClaw automaticamente, já com todas as dependências do Docker e o ambiente prontos para uso.
Na prática, esse método é mais rápido, simples e com menos chances de erro do que fazer tudo manualmente.<\/p>Se você ainda não é cliente da Hostinger, acesse nossa página de VPS OpenClaw<\/a>, escolha o plano desejado, o período de cobrança e a localização do servidor.<\/p>
Você também pode adquirir créditos Nexos AI. Esse complemento permite conectar o OpenClaw a LLMs da OpenAI, Anthropic, Google e xAI sem precisar configurar APIs individuais — tudo funciona imediatamente após a instalação.<\/p>
\n![\"Janela](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2026\/01\/comprando-vps-openclaw-hostinger.png\/public\")
- Envie \/mybots<\/strong><\/li>\n\n\n\n
- Inicie um bate-papo e envie \/newbot<\/strong><\/li>\n\n\n\n
- Verifique se o container está em execução: docker compose ps<\/strong><\/li>\n\n\n\n