Instalar OpenClaw em 5 minutos
Instale primeiro no seu computador. Depois que responder uma mensagem, você decide se vale migrar para nuvem 24/7.
Se você ainda não sabe qual tarefa automatizar primeiro, abra o diagnóstico OpenClaw e receba o checklist de 12 perguntas antes de instalar. Depois da instalação, siga o guia como usar OpenClaw como agente de IA para transformar o primeiro canal em uma rotina real.
rota recomendada
Local primeiro. Nuvem depois.
O objetivo desta página é simples: sair com o OpenClaw instalado, um canal conectado e uma primeira mensagem respondida.
gerador de comando
Monte seu comando de instalação
Escolha seu sistema, canal e modelo. O bloco abaixo vira o passo a passo exato para copiar e colar.
Selecione as opções acima para gerar os comandos.Os comandos seguem o guia oficial de instalação abaixo.
O caminho curto
Verifique se seu terminal já tem Node v22 ou v24.
Use o comando de instalação global via npm.
Deixe o wizard criar gateway, workspace e serviço.
Comece por WhatsApp. Telegram, Discord e Slack podem vir depois.
1. Confirme o Node.js
Abra o terminal e rode:
node --version
npm --version
Se o Node.js responder v22.x ou v24.x, pule para instalar o OpenClaw.
Nunca usei terminal. O que faço?
No macOS, abra o app Terminal. No Linux, abra Terminal. No Windows, instale WSL2 e abra Ubuntu. Copie uma linha por vez, cole, aperte Enter e espere terminar antes da próxima.
2. Instale o OpenClaw
npm install -g openclaw@latest
openclaw onboard --install-daemonO primeiro comando instala o OpenClaw. O segundo abre o wizard e configura o serviço local.
3. Abra o wizard
O wizard pergunta três coisas:
| Pergunta | Resposta segura para começar |
|---|---|
| Modelo de IA | Claude, GPT ou Ollama local |
| Pasta de trabalho | Aceite o padrão ~/clawd |
| Serviço em background | Sim, para responder mesmo com terminal fechado |
Quando aparecer Gateway iniciado na porta 3434, continue.
openclaw gateway status
4. Conecte um canal
Comece por um canal só. O mais rápido para a maioria das pessoas é WhatsApp.
recomendado
openclaw channel add whatsappEscaneie o QR code como no WhatsApp Web. Se o QR expirar, rode openclaw gateway restart e tente de novo.
dev
Telegram
openclaw channel add telegramCrie um bot no @BotFather e cole o token quando o OpenClaw pedir.
equipe
Discord ou Slack
openclaw channel add discord
openclaw channel add slackUse quando já tiver um workspace ou servidor onde o bot precisa atuar.
5. Teste se funcionou
Envie uma mensagem simples para o canal conectado:
Olá! O que você pode fazer por mim?
resultado esperado
Se respondeu, a instalação acabou.
Agora configure memória, personalidade e sua primeira automação útil.
O que fazer depois de instalarSe deu erro
Rode o diagnóstico primeiro. Ele costuma apontar o problema direto.
openclaw doctor
openclaw gateway logs -f
EACCES ou permission denied no npm
Configure uma pasta global sem permissão de administrador:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
echo 'export PATH=~/.npm-global/bin:$PATH' \
>> ~/.bashrc
source ~/.bashrc
npm install -g openclaw@latest
command not found: openclaw
O npm global não está no PATH. Feche e abra o terminal. Se continuar, rode:
npm config get prefix
npm bin -g
Adicione a pasta retornada ao seu PATH no .bashrc, .zshrc ou perfil do shell.
Gateway não inicia
Veja se a porta está ocupada ou se outra cópia do OpenClaw já está rodando:
openclaw gateway status
lsof -i :3434
pkill -f openclaw
openclaw gateway start
QR code do WhatsApp expira
Feche outras sessões do WhatsApp Web, reinicie o gateway e escaneie logo que o QR aparecer:
openclaw gateway restart
openclaw channel add whatsapp
Se travar mesmo assim, use o troubleshooting completo ou poste o erro no Discord.
Depois que responder
Escolha um próximo passo. Não faça todos ao mesmo tempo.
Rodar 24/7 na nuvem
Só vá para nuvem depois de testar localmente. Assim você sabe que canal, API key e fluxo básico funcionam.
| Opção | Custo | Use quando |
|---|---|---|
| Oracle Cloud grátis | $0/mês | Quer 24/7 sem pagar servidor |
| DigitalOcean | $6/mês | Quer o caminho pago mais simples |
| VPS universal | varia | Já tem servidor próprio |
Perguntas rápidas
Preciso saber programar?
Não. Você precisa copiar comandos no terminal. Se algo falhar, openclaw doctor e a seção de erros acima cobrem os travamentos comuns.
Meus dados ficam privados?
O OpenClaw roda no seu computador. Mensagens só saem para o provedor de IA que você escolher, como Claude, GPT ou um modelo local via Ollama.
Quanto custa?
O OpenClaw é gratuito. Você paga apenas a API de IA se usar Claude ou GPT. Com Ollama local, o custo de API pode ser zero. Veja a análise de custos.
Posso usar Docker?
Sim, mas para a primeira instalação o caminho local via npm é mais fácil de depurar. Se você já usa containers, veja o guia Docker.
Guias por plataforma
Se precisar de mais detalhe do seu sistema: