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 recente (o app desktop com instalador gráfico pede macOS 15 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
Node.js não precisa estar instalado: o OpenClaw exige Node 24.16+ ou 26.1+ (26 recomendado), e o instalador oficial provisiona o Node quando ele falta. Só se preocupe com isso se for instalar manualmente via npm install -g openclaw@latest --allow-scripts=openclaw.

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: confere o sistema, instala o Node.js e o Git se faltarem, instala o OpenClaw e já pode iniciar o onboarding.

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 o sistema (macOS, Linux ou WSL)
Confere o Node.js e, se precisar, instala o Node 26 (macOS, via Homebrew) ou o Node 24 LTS (Linux)
Instala o Git se ele não existir
Instala o OpenClaw como pacote npm global e roda um diagnóstico de reparo no fim

Referência: como o instalador funciona (documentação oficial).

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 comando openclaw estiver disponível, 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/openclaw.json
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 a versão instalada, no formato de data do OpenClaw (ex.: 2026.9.5).

openclaw status

A saída confirma que o daemon está rodando, mostra o caminho do openclaw.json e quantos agentes e canais estão ativos (zero logo após a instalação).

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

openclaw gateway 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 aparece na faixa de R$ 43,99/mês no ciclo promocional, com renovação de R$ 77,99/mês (verificado em agosto de 2026). 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.

Acesso ao dashboard (porta 18789): por padrão o gateway escuta só no loopback (gateway.bind: "loopback"), ou seja, apenas conexões locais. Não exponha essa porta na internet com ufw allow 18789 — a documentação do OpenClaw recomenda manter o gateway no loopback e acessar por túnel SSH ou Tailscale. A partir do seu computador:

ssh -N -L 18789:127.0.0.1:18789 usuario@SEU_IP

Depois abra http://localhost:18789. No firewall do VPS, deixe liberada só a porta do SSH (22). Passo a passo de túnel SSH e Tailscale: acesso remoto seguro ao OpenClaw.

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

Não resolva com sudo curl ... | bash: o sudo só vale para o curl, e rodar o OpenClaw como root cria arquivos que o seu usuário depois não consegue ler. Rode o instalador de novo como o seu usuário normal e, em seguida:

openclaw doctor

O doctor aponta o que ficou faltando (Node, permissões, serviço do Gateway). Se o erro persistir, a página oficial de instalação lista as alternativas por sistema.

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

A pasta onde o npm coloca comandos globais não está no seu PATH. Descubra qual é e adicione:

npm prefix -g   # ex.: /home/voce/.npm-global
export PATH="$PATH:$(npm prefix -g)/bin"

Para tornar permanente, coloque a linha export PATH=... (com o caminho que o npm prefix -g mostrou, seguido de /bin) no fim do ~/.bashrc ou ~/.zshrc. Instalou pelo método Git? Aí o comando fica em ~/.local/bin — adicione essa pasta no lugar.

O daemon não inicia

Veja os logs para entender o que aconteceu:

openclaw logs --follow

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.

Conteúdo original do OpenClaw Club Brasil, escrito para o mercado brasileiro. Referência oficial: documentação do OpenClaw.