Como Configurar OpenClaw em um VPS: O Guia Direto ao Ponto

A maioria dos tutoriais OpenClaw desperdiça seus primeiros 10 minutos explicando o que é um agente IA. Você já sabe. Quer seu próprio agente rodando num servidor, acessível do seu celular, fazendo trabalho real. Vamos chegar lá.

Este guia cobre a configuração completa — de criar um VPS a conversar com seu agente no Telegram. Tempo total: cerca de 25 minutos se digitar em ritmo normal.

O que Precisa Antes de Começar

• Um VPS com pelo menos 2 vCPUs, 4GB RAM e 40GB armazenamento (Ubuntu 22.04 ou mais novo)
• Uma chave API da Anthropic, OpenAI ou Google — escolha uma
• Uma conta Telegram (ou WhatsApp, Discord, Slack — Telegram é mais rápido para configurar)
• Conforto básico com terminal. Não precisa ser sysadmin, mas deve saber o que ssh significa

Qualquer provedor VPS funciona. Hetzner, DigitalOcean, Linode, Vultr, Hostinger — todos rodam Ubuntu bem. O tier mais barato que atende o requisito RAM é suficiente para um agente único.

Passo 1: SSH no Seu Servidor

Uma vez que seu VPS está provisionado, pegue o endereço IP do dashboard do provedor e conecte:

ssh root@IP_SEU_SERVIDOR

Primeiro login numa caixa Ubuntu fresca? Atualize pacotes:

apt update && apt upgrade -y

Passo 2: Instalar OpenClaw

Um comando. Sério.

curl -fsSL https://openclaw.ai/install.sh | bash

O instalador cuida de Node.js, dependências e binário OpenClaw. Leva 2-3 minutos dependendo da velocidade internet do seu servidor.

Após instalação, rode o wizard de configuração inicial:

openclaw onboard --install-daemon

A flag --install-daemon configura OpenClaw para iniciar automaticamente no boot. Pule se preferir controle manual, mas para VPS que deve rodar 24/7, você quer isso.

O wizard te guia através de:

1. Escolher provedor IA (Anthropic, OpenAI, Google ou Ollama para modelos locais)
2. Inserir sua chave API
3. Definir modelo padrão
4. Configurar seu primeiro canal de chat

Passo 3: Conectar Telegram

Abra Telegram e busque @BotFather. Inicie chat e envie:

/newbot

BotFather pede nome de exibição e username (deve terminar em bot). Dê o que quiser — "MeuAgenteBot", "BuddyTrabalhoBot", não importa.

Copie o token API que BotFather te dá. De volta no terminal:

openclaw channels add --channel telegram --token SEU_TOKEN_BOT

Agora abra chat com seu novo bot no Telegram e envie /start. O bot responde com código de pareamento. Copie esse código, volte ao terminal e aprove:

openclaw pair approve CODIGO_PAREAMENTO

Envie mensagem teste ao seu bot. Se responder, está conectado.

Passo 4: Escolha Seu Modelo

Durante configuração inicial escolheu um padrão, mas pode mudar a qualquer hora:

openclaw models set anthropic/claude-sonnet-4-20250514

Ou se quer algo mais barato para uso casual:

openclaw models set anthropic/claude-haiku-4-5-20251001

A escolha do modelo afeta custo e qualidade. Sonnet é o sweet spot para maioria das pessoas — inteligente suficiente para trabalho real, acessível suficiente para deixar rodando. Opus é para tarefas raciocínio complexo. Haiku é para interações alto volume, baixa importância.

Verifique sua configuração:

openclaw doctor

Isso mostra status gateway, canais conectados, modelo IA e quaisquer avisos.

Passo 5: Dê uma Identidade ao Seu Agente

OpenClaw usa arquivo chamado SOUL.md no seu workspace para definir personalidade e comportamento do seu agente. Pode editá-lo diretamente:

nano ~/.openclaw/workspace/SOUL.md

Ou apenas diga ao seu agente através do Telegram: "Atualize seu SOUL.md — você é um desenvolvedor sênior que fala de forma concisa e usa exemplos de código. Seu nome é Atlas."

O agente atualizará seu próprio arquivo de personalidade. Isso molda cada resposta daqui em diante.

Passo 6: Instalar Skills

Skills estendem o que seu agente pode fazer. Navegue o que está disponível:

openclaw skill search web

Instale alguns essenciais:

openclaw skill install web-search
openclaw skill install weather

Para lista de skills construídas pela comunidade, veja ClawHub — é o marketplace de skills onde pode encontrar de tudo, de integração Gmail a ferramentas auditoria segurança.

Passo 7: Trancar Segurança

Seu agente tem acesso shell ao seu servidor. É poderoso mas perigoso se mal configurado. Execute auditoria segurança:

openclaw security audit --deep

No mínimo:

• Mude SSH para auth baseada em chave — desabilite login senha
• Configure firewall — permita apenas portas 22 (SSH) e 443 (se usar dashboard)
• Revise permissões do agente — modo sandbox limita quais comandos pode executar
• Não dê credenciais root de outros serviços ao seu agente a menos que confie na configuração

A documentação oficial segurança cobre endurecimento em detalhes. Leia. Um agente IA comprometido com acesso shell é pior que apenas servidor comprometido.

Passo 8: Configurar Jobs Cron (Opcional mas Útil)

Quer que seu agente verifique seu email toda manhã? Te envie relatório tempo? Resume mensagens noturnas?

openclaw cron add --schedule "0 8 * * *" --message "Verifique minha caixa entrada e resuma qualquer coisa importante"

Jobs cron rodam em sessões isoladas, então não poluem seu histórico conversa principal.

Verifique que Tudo Funciona

Execute esta checklist:

1. openclaw gateway status — deve dizer "running"
2. Envie mensagem ao seu bot no Telegram — deve receber resposta
3. Peça ao seu agente para buscar na web — confirma skills funcionando
4. openclaw doctor — todas verificações devem passar

Se algo quebrou, openclaw doctor geralmente diz o quê. Problemas mais comuns: formato chave API errado, token Telegram não colado corretamente, ou firewall bloqueando conexões saída.

Expectativas de Custo

O próprio VPS: R$ 25-75/mês dependendo do provedor e specs.

Custos API dependem inteiramente do uso. Com Sonnet como modelo padrão, uso casual (20-30 mensagens/dia) fica cerca de R$ 15-40/mês. Uso pesado com sub-agentes e tarefas pesquisa pode chegar R$ 150-250/mês. Monitore seus gastos através do dashboard do provedor API.

O que Vem Depois

Você tem um agente rodando. Agora o torne útil:

• Configure seu AGENTS.md para definir comportamento autônomo
• Construa pipeline de conteúdo para escrita automatizada
• Explore arquiteturas multi-agente para fluxos complexos

Precisa ajuda com configuração? MayaWorks oferece configuração como serviço — configuramos tudo e te entregamos agente funcionando.