Configurando OpenClaw em um Servidor Privado

Configurar o OpenClaw (anteriormente conhecido como Moltbot/Clawbot) em um servidor privado envolve preparar o ambiente VPS, clonar o repositório do projeto, executar o script de configuração Docker, definir as credenciais do provedor de IA e conectar a uma plataforma de mensagens.

O processo é direto e leva cerca de 30 minutos do início ao fim. Ao final, você terá seu próprio assistente de IA respondendo mensagens 24 horas por dia, 7 dias por semana.

Embora seja tecnicamente possível executar o OpenClaw no seu próprio notebook, isso tem limitações óbvias. Se você desligar o computador ou perder a conexão com a internet, seu bot ficará offline.

É por isso que executá-lo em um servidor privado é tão vantajoso: oferece disponibilidade consistente e execução em segundo plano, mesmo quando você está offline, garantindo que seu bot funcione 24/7 sem necessidade de supervisão constante.

1. Preparando o Servidor Privado

Para preparar um servidor privado para o OpenClaw, você precisa de um VPS Linux com acesso administrativo completo. Esta é a base do seu projeto, pois um servidor sempre ativo garante que seu bot nunca durma.

Você não precisa de um supercomputador, mas precisa atender a requisitos específicos para garantir estabilidade.

Checklist do Servidor

• Sistema operacional Linux (Ubuntu 22.04 ou 24.04 funcionam muito bem)

• Acesso administrativo (privilégios root ou sudo)

• Docker e Docker Compose instalados

• Pelo menos 2GB de RAM (4GB recomendado para melhor desempenho)

• 10GB+ de espaço em disco para imagens Docker, dados da aplicação e logs

Se você é novo na configuração de VPS, certifique-se de poder acessar seu servidor via SSH antes de continuar.

2. Verificando a Disponibilidade do Docker

O Docker é como executaremos o OpenClaw. Pense no Docker como um contêiner que empacota tudo o que o OpenClaw precisa em uma única unidade organizada. Em vez de instalar manualmente dependências e configurar diferentes detalhes, o Docker cuida de tudo. É mais limpo, mais confiável e muito mais fácil de gerenciar.

Acesse seu servidor via SSH e execute:

Você deve ver os números de versão tanto do Docker quanto do Docker Compose. Se receber “command not found”, o Docker ainda não está instalado.

Uma configuração adequada do OpenClaw depende de um sistema Docker saudável. Para instalá-lo manualmente, procure tutoriais sobre como instalar Docker no Ubuntu e verifique novamente.

Assim que o Docker estiver confirmado e em execução, você está pronto para a implantação real do OpenClaw.

3. Clonando o Repositório OpenClaw

Agora vamos para a parte interessante. Vamos clonar o repositório OpenClaw e usar o script oficial de configuração Docker para construir e implantar tudo.

Primeiro, obtenha o código do OpenClaw no seu servidor:

Este script de configuração é sua solução completa para colocar o OpenClaw em funcionamento. Aqui está o que ele faz:

• Constrói a imagem Docker do OpenClaw localmente (a partir do Dockerfile incluído)

• Executa o assistente de integração dentro de um contêiner Docker

• Gera um token de gateway para acessar a Interface de Controle

• Cria os diretórios de configuração necessários

• Inicia o gateway OpenClaw via Docker Compose

Todo o processo é automatizado. Diferente de muitos aplicativos Docker onde você puxa uma imagem pré-construída, o OpenClaw constrói a imagem localmente no seu servidor. Isso significa:

• Você está sempre executando a versão exata do repositório

• A primeira construção leva alguns minutos

• Reconstruções subsequentes são mais rápidas graças ao cache de camadas do Docker

• Você tem controle total sobre o que está incluído

4. Configurando Credenciais e Definições

O script de configuração Docker lança um assistente de integração interativo que configura o OpenClaw para você. É aqui que você definirá as credenciais do provedor de IA e outras configurações essenciais.

Ao executar ./docker-setup.sh, após construir a imagem, você verá o assistente de integração fazendo várias perguntas importantes:

Modo Gateway

• Local (executar nesta máquina)

• Remoto (conectar a gateway existente)

Escolha Local. Isso significa que o gateway é executado no seu VPS.

Método de Autenticação

Esta é a parte mais crítica. Você precisa informar ao OpenClaw como acessar os modelos de IA:

• Chave API Anthropic (recomendado)

• Chave API OpenAI

• OAuth (assinatura Claude Pro/Max)

• Código OpenAI (assinatura Codex)

Se você optar pela opção recomendada de Chave API Anthropic, precisará:

1. Fazer login ou se cadastrar na Anthropic

2. Navegar até API Keys

3. Criar uma nova chave

4. Copiá-la e colá-la no assistente de configuração

Importante: Mantenha esta chave segura. Qualquer pessoa com esta chave pode usar Claude na sua conta e você será cobrado pelo uso deles.

O processo é o mesmo com as outras opções – você obtém uma chave da plataforma de IA e a adiciona na configuração. O assistente armazena essas credenciais como variáveis de ambiente nos seus arquivos de configuração.

Em seguida, você escolhe o modelo para a plataforma de IA selecionada e define as configurações de segurança.

Erro comum: O erro de configuração mais comum é uma chave API ausente. Sem uma chave Anthropic ou OpenAI válida, o OpenClaw não funcionará. Ambas as plataformas exigem um método de pagamento cadastrado para acesso à API, portanto certifique-se de que sua chave API está ativa e tem cobrança configurada.

5. Iniciando e Verificando o OpenClaw

Uma vez que o script de configuração seja concluído, o OpenClaw já deve estar em execução.

Para verificar se tudo está funcionando corretamente, verifique o status do contêiner:

Você deve ver openclaw-gateway com status “Up” ou “Running”. Outros sinais de que tudo está funcionando corretamente incluem:

• Mensagem “OpenClaw initialized”

• Provedor de modelo conectado (Anthropic/OpenAI)

• Sem erros de autenticação

Por outro lado, se você vir “Invalid API key”, “Authentication failed”, “Connection refused”, ou se o contêiner continuar reiniciando, então você tem um erro.

Pare aqui e corrija-os antes de continuar, verificando os logs:

Isso é importante para solução de problemas. Os logs do OpenClaw mostram o que o bot está realmente fazendo, para que você possa resolver os problemas.

6. Acessando a Interface OpenClaw

O painel do OpenClaw é acessível através do endereço IP do seu VPS na porta 18789:

Por exemplo: http://45.123.45.67:18789

Quando você visitar a Interface de Controle pela primeira vez, precisará do token de gateway gerado durante a configuração. Encontre-o em:

Ou verifique a saída de quando você executou ./docker-setup.sh – ele exibe o token no final.

Nota: Embora o projeto tenha sido renomeado para OpenClaw, os arquivos e diretórios de configuração ainda usam a nomenclatura “clawdbot” (como ~/.clawdbot/ e CLAWDBOT_GATEWAY_TOKEN). Isso é normal durante a transição e não afeta a funcionalidade.

Uma vez dentro do painel, vá para Settings → Token (ou você pode ser solicitado imediatamente). Cole seu token de gateway e clique em Save ou Authenticate.

Esta interface OpenClaw é seu centro de controle. Você não precisa configurar tudo agora – apenas confirme que pode acessá-la e que o OpenClaw aparece como saudável.

Solução de Problemas de Acesso

Se você não conseguir acessar a interface:

• Verifique se o contêiner está realmente em execução: docker compose ps

• Verifique se seu firewall não está bloqueando a porta

• Certifique-se de estar usando HTTP, não HTTPS

• Tente acessar do próprio servidor: curl http://localhost:18789

7. Conectando um Canal de Mensagens

O painel web que acabamos de configurar é para gerenciamento, mas você interagirá com o OpenClaw através de um aplicativo de mensagens onde as conversas com IA acontecem.

Vamos passar por como configurar com o Telegram, pois é direto, mas o processo é similar para outras plataformas.

Configuração do Telegram

Passo 1: Criar um bot no Telegram

1. Abra o Telegram e procure por @BotFather

2. Inicie uma conversa e envie /newbot

3. Siga as instruções:

   • Escolha um nome (ex: Meu Assistente OpenClaw)

   • Escolha um nome de usuário (deve terminar em “bot”, como “meuawesomemoltbot”)

4. BotFather lhe dará um token do bot. Copie-o.

Passo 2: Adicionar Telegram ao OpenClaw

De volta ao seu servidor, execute:

Substitua SEU_TOKEN_DO_BOT pelo token real do BotFather.

Passo 3: Habilitar permissões necessárias do bot

No chat do BotFather:

1. Envie /mybots

2. Selecione seu bot

3. Vá para Bot Settings → Group Privacy

4. Desabilite a privacidade do grupo (isso permite que o bot leia mensagens em grupos)

Passo 4: Começar a conversar

1. Abra o Telegram e procure seu bot (pelo nome de usuário que você escolheu)

2. Inicie uma conversa

3. Envie uma mensagem para testá-lo

Se você configurou o emparelhamento DM durante a configuração, receberá um código de emparelhamento. No seu servidor, aprove-o:

Após a aprovação, envie outra mensagem. O OpenClaw deve responder!

Problemas com Mensagens?

Se as mensagens não estiverem funcionando:

• Verifique os logs do OpenClaw em busca de erros

• Verifique se as chaves API ainda são válidas

• Certifique-se de que o contêiner não reiniciou ou travou

• Confirme se as credenciais da plataforma de mensagens estão corretas

Solucionando Problemas Comuns

Para solucionar problemas comuns de configuração do OpenClaw, verifique primeiro o status do contêiner, valide seu token de gateway e examine os logs em busca de mensagens de erro específicas. A maioria dos problemas se enquadra em algumas categorias previsíveis e, uma vez que você saiba o que procurar, eles são rápidos de corrigir.

Contêiner Continua Parando

Se seu contêiner inicia e imediatamente para:

Causas comuns: chave API ausente ou inválida, porta 18789 já em uso, problemas de configuração do Docker Compose, ou permissões insuficientes.

Falhas de Autenticação

O problema mais comum de longe. Se você vir “authentication failed”, “invalid API key”, ou falhas de solicitação de modelo, verifique sua chave API:

Procure por ANTHROPIC_API_KEY ou OPENAI_API_KEY. Certifique-se de que:

• A chave está presente e não está vazia

• Não há espaços extras ou aspas

• A chave não foi revogada ou expirou

• O status de cobrança está ativo

Para adicionar novamente suas credenciais:

Conflitos de Porta

Se você receber erros de “port already in use” ou “address already in use”:

Altere a porta do OpenClaw editando docker-compose.yml ou use um mapeamento de porta diferente: -p 18790:18789

Loops de Reinicialização

Se o contêiner continua reiniciando, geralmente significa que há variáveis de ambiente ausentes, arquivos de configuração corrompidos, configuração de modelo inválida ou problemas de permissão.

Para corrigir:

Não Consegue Acessar a Interface

Se o contêiner está em execução, mas você não consegue acessar o painel:

• Verifique as regras de firewall e permita a porta 18789: sudo ufw allow 18789/tcp

• Verifique se o contêiner está escutando: curl http://localhost:18789

• Verifique as configurações do provedor VPS, pois alguns provedores exigem que você configure grupos de segurança para permitir tráfego de entrada na porta 18789

Reiniciando com Segurança

Você precisará reiniciar o OpenClaw quando alterar variáveis de ambiente, se o bot ficar sem resposta, ou após atualizações de configuração específicas.

Reinicialização rápida:

Reinicialização limpa (mais controle):

Melhores Práticas para Executar OpenClaw

Práticas de Segurança

• Nunca compartilhe seu token de gateway – trate-o como uma senha

• Use um firewall e exponha apenas as portas necessárias

• Mantenha o SSH seguro usando autenticação baseada em chaves

• Restrinja o acesso à interface usando VPN ou whitelist de IP se não precisar de acesso público

Gerenciamento de Recursos

O OpenClaw é relativamente leve, mas você deve ficar de olho em:

• Uso de memória: verifique ocasionalmente com docker stats openclaw-gateway

• Espaço em disco: logs podem se acumular, considere rotação de logs

• Uso de CPU: picos são normais durante conversas ativas, mas uso alto sustentado pode indicar um problema

Se você notar problemas de recursos, pode ser necessário atualizar seu VPS ou investigar o que está causando uso excessivo.

Estratégia de Atualização

Novas versões do OpenClaw são lançadas periodicamente com melhorias e correções:

• Verifique atualizações mensalmente

• Teste atualizações em ambiente de não-produção primeiro, se possível

• Mantenha um backup da sua configuração atual antes de atualizar

• Leia as notas de lançamento para entender o que mudou

Monitoramento de Tempo de Atividade

Configure monitoramento básico para saber se o OpenClaw cair:

• A política de reinicialização do Docker ajuda na recuperação automática

• Considere um monitor de tempo de atividade simples (existem muitos serviços gratuitos)

• Verifique os logs periodicamente em busca de erros ou avisos incomuns

• Teste seus canais de mensagens ocasionalmente para confirmar funcionalidade

Backup de Configuração

Suas variáveis de ambiente (especialmente o token de gateway) são essenciais para a configuração:

• Armazene seu token em um gerenciador de senhas

• Mantenha notas sobre suas configurações

• Documente quaisquer variáveis de ambiente personalizadas que você adicionou

Gerenciando OpenClaw Após a Configuração

O gerenciamento do dia a dia é mínimo quando tudo está funcionando bem, mas um pouco de atenção contínua mantém as coisas saudáveis.

Verificar Logs Regularmente

Crie o hábito de dar uma olhada nos logs semanalmente:

Procure por: erros ou avisos repetidos, problemas de desempenho, problemas de conexão, ou padrões incomuns.

Na maioria das vezes, você verá operação regular, mas identificar problemas cedo previne problemas maiores.

Atualizar OpenClaw

Quando uma nova versão for lançada:

Monitorar Tempo de Atividade

Verifique o status do contêiner periodicamente. Deve mostrar status como “Up”, mas se estiver reiniciando frequentemente, investigue os logs.

Monitorar Desempenho

A cada algumas semanas, verifique o uso de recursos:

Isso mostra uso de CPU, memória e rede em tempo real. Se o uso parecer alto, você pode precisar:

• Investigar o que está causando isso (verifique os logs)

• Atualizar seu VPS se você superou as especificações atuais

• Otimizar sua configuração

Você não precisa se preocupar com escalonamento, clustering ou otimizações complexas para a maioria dos casos de uso. O OpenClaw funciona bem em um único VPS para uso pessoal ou de equipes pequenas.

Concentre-se em: mantê-lo funcionando de forma confiável, atualizar quando necessário, monitorar erros, e manter os fundamentos de segurança.