Instalação e Setup do OpenClaw: Guia Completo em PT-BR

Se você chegou aqui, provavelmente já entendeu o que o OpenClaw faz e quer colocar a mão na massa. Ótimo. Este capítulo te leva do zero até uma instalação funcionando — seja no seu computador local ou em um VPS na Hostinger.

Não precisa ser desenvolvedor experiente para seguir esse guia. Você vai precisar de familiaridade básica com terminal, mas cada comando está explicado linha por linha.

O Que é o OpenClaw

O OpenClaw é um runtime de agentes de IA open source. Em termos práticos: você instala ele em um servidor ou no seu computador, configura um agente, conecta a um canal (WhatsApp, Telegram, etc.) e ele começa a trabalhar.

Diferente de plataformas de automação como n8n ou Zapier, o OpenClaw é construído em torno de agentes com raciocínio — o agente não só executa passos pré-definidos, ele entende o contexto, toma decisões e pode executar múltiplas ferramentas em sequência para resolver um problema.

Para o mercado brasileiro, isso significa que você pode ter um atendente automático no WhatsApp que realmente entende o que o cliente perguntou e responde de forma útil, sem precisar mapear cada variação de mensagem manualmente.

Pré-requisitos

Antes de instalar, confirme que você tem:

Sistema operacional compatível:

Linux Ubuntu 22.04 LTS ou superior (recomendado para VPS)
macOS 13 (Ventura) ou superior
Windows com WSL2 (funciona, mas VPS é mais simples)

Recursos mínimos:

2 GB de RAM (4 GB recomendado para uso contínuo)
10 GB de espaço em disco
Conexão com a internet (para baixar o instalador e chamar APIs de IA)

Ferramentas necessárias no sistema:

curl — para baixar o instalador
bash — shell padrão na maioria dos sistemas Linux/macOS

Verifique se o curl está instalado:

curl --version

Se retornar algo como curl 7.81.0, está pronto. Se der “command not found”, instale:

# Ubuntu/Debian
sudo apt update && sudo apt install -y curl

# macOS (com Homebrew)
brew install curl

Instalando o OpenClaw

O instalador oficial cuida de tudo: baixa o binário correto para o seu sistema, coloca no PATH, cria os diretórios de configuração e verifica dependências.

Execute este único comando:

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

O que esse comando faz passo a passo:

Baixa o script de instalação com segurança (-fsSL garante que erros de rede causam falha, não executam um script corrompido)
Detecta seu sistema operacional e arquitetura
Baixa o binário correto do OpenClaw
Instala em /usr/local/bin/openclaw (ou ~/.local/bin/ se não tiver permissão de root)
Cria os diretórios de configuração em ~/.openclaw/

A instalação leva de 30 segundos a 2 minutos dependendo da sua conexão.

Após a instalação, feche e reabra o terminal (ou execute source ~/.bashrc / source ~/.zshrc).

Configuração Pós-Instalação

Assim que o binário estiver instalado, execute o onboarding para configurar o daemon (o processo que mantém o OpenClaw rodando em background):

openclaw onboard --install-daemon

Esse comando vai:

Criar o arquivo de configuração inicial em ~/.openclaw/config.yaml
Instalar o daemon como serviço do sistema (systemd no Linux, launchd no macOS)
Gerar uma chave de API local para acesso seguro

Você vai ser perguntado algumas coisas durante o onboarding — responda conforme o seu caso de uso. Pode mudar tudo depois nas configurações.

Verificando a Instalação

Dois comandos para confirmar que tudo está funcionando:

openclaw --version

Deve retornar algo como openclaw v0.9.4 (linux/amd64).

openclaw status

Saída esperada:

OpenClaw Daemon: running
Config: ~/.openclaw/config.yaml
Agents loaded: 0
Channels active: 0

Se o daemon não estiver rodando, inicie manualmente:

openclaw daemon start

Na Prática: Instalação em VPS Hostinger

Se você está instalando em um servidor na Hostinger (a opção mais comum para rodar OpenClaw 24/7 no Brasil), siga este passo a passo do zero.

Por que Hostinger? O plano KVM2 hoje aparece na faixa de R$ 43,99/mês no ciclo promocional, com renovação de R$ 77,99/mês. Ele tem 2 vCPUs, 8 GB de RAM e 100 GB de SSD — mais do que suficiente para rodar o OpenClaw com um ou dois agentes ativos. O suporte está disponível em português e o painel é simples de usar.

1. Crie o VPS

No painel Hostinger, selecione Ubuntu 22.04 LTS como sistema operacional. Após criação, o painel vai mostrar o IP do servidor e a senha root.

Se quiser encurtar o caminho: crie seu VPS na Hostinger e depois volte para este passo a passo.

2. Acesse via SSH

ssh root@SEU_IP_AQUI

Na primeira vez vai pedir confirmação da chave do servidor — digite yes.

3. Atualize o sistema

apt update && apt upgrade -y

Isso pode levar 2-5 minutos. Aguarde terminar.

4. Instale o OpenClaw

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

5. Configure o daemon

openclaw onboard --install-daemon

6. Verifique

openclaw status

Pronto. O VPS vai manter o OpenClaw rodando mesmo depois de você desconectar o SSH, porque o daemon está registrado como serviço do sistema.

Porta do webhook: se você conectar WhatsApp ou Telegram, o OpenClaw precisa receber webhooks. No VPS, libere a porta configurada (padrão 18789) no firewall:

sudo ufw allow 18789/tcp

Sem isso, o canal se conecta mas mensagens não chegam.

Para o próximo passo, configure um agente — veja o capítulo de configuração inicial.

Problemas Comuns e Soluções

“curl: command not found”

O curl não está instalado. No Ubuntu:

apt install -y curl

“permission denied” ao instalar

O instalador tentou escrever em /usr/local/bin/ sem permissão. Solução:

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

Ou instale como usuário atual (sem sudo) — o instalador vai usar ~/.local/bin/ como fallback.

“openclaw: command not found” após instalação

O diretório de instalação não está no seu PATH. Execute:

export PATH="$PATH:$HOME/.local/bin"
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc

O daemon não inicia

Veja os logs para entender o que aconteceu:

openclaw logs --daemon --last 50

Na maioria dos casos é falta de permissão de escrita em ~/.openclaw/ — resolva com chmod 700 ~/.openclaw/.

Conexão lenta ou timeout durante download

Se o seu VPS ou rede está com latência alta para os servidores do OpenClaw, tente:

curl -fsSL --retry 3 --retry-delay 2 https://openclaw.ai/install.sh | bash

Com a instalação feita e o daemon rodando, você está pronto para entender como o OpenClaw funciona por dentro. Isso é importante antes de criar seu primeiro agente — uma hora gasta entendendo a arquitetura do OpenClaw vai economizar muito tempo de debugging depois.

Também vale conferir a página de início se ainda tem dúvidas sobre casos de uso antes de continuar.

Baseado no “Automate Everything: The OpenClaw Handbook” por Kelly Claude (CC BY 4.0). Adaptado e expandido para o mercado brasileiro.