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.

Pré-requisitos para instalar o OpenClaw

Antes de instalar o OpenClaw, confira a lista mínima abaixo. Se faltar qualquer item, a instalação costuma travar em um destes pontos — por isso vale alinhar tudo antes de abrir o terminal.

• Node.js 22 ou superior — o OpenClaw é um app Node. Sem ele, o comando npm não existe. Veja como confirmar a versão na seção 1.
• 300 MB livres em disco — para o runtime, a pasta de trabalho ~/clawd e o primeiro modelo de IA.
• Conexão estável com a internet — só durante a instalação e ao chamar a API de IA. Com Ollama local, a IA roda offline depois de baixada.
• Terminal com permissão de usuário comum — não use sudo com o npm; isso quebra as permissões globais e é a causa nº 1 de erro na instalação (veja erros comuns).
• Uma chave de API (opcional no primeiro minuto) — Claude ou GPT para começar a responder logo. Se o objetivo for custo zero, use Ollama como modelo local.
• Um canal de mensagens pronto — número de WhatsApp dedicado, bot do Telegram via BotFather, ou servidor de Discord/Slack.

Quem já tem o Node.js instalado conclui a instalação do OpenClaw em cerca de 5 minutos. Quem precisa instalar o Node.js primeiro conta mais 3 a 5 minutos, dependendo do sistema operacional — os atalhos por plataforma estão na seção 1.

Selecione as opções acima para gerar os comandos.

O caminho curto

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.

brew install node@24

nvm install 24
nvm use 24

wsl --install -d Ubuntu

2. Instale o OpenClaw

npm install -g openclaw@latest
openclaw onboard --install-daemon

O 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:

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.

openclaw channel add whatsapp

openclaw channel add telegram

openclaw channel add discord
openclaw channel add slack

5. Teste se funcionou

Envie uma mensagem simples para o canal conectado:

Olá! O que você pode fazer por mim?

Se deu erro

Rode o diagnóstico primeiro. Ele costuma apontar o problema direto. Para os 7 erros mais comuns na instalação do OpenClaw — permissão do npm, command not found, porta 3434 ocupada e QR do WhatsApp expirando — com a solução passo a passo de cada um, veja o guia de erros comuns na instalação do OpenClaw.

openclaw doctor
openclaw gateway logs -f

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

npm config get prefix
npm bin -g

openclaw gateway status
lsof -i :3434
pkill -f openclaw
openclaw gateway start

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 — o checklist de pós-instalação ajuda a ordenar memória, personalidade e a primeira automação na sequência certa.

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.

Perguntas rápidas

Guias por plataforma

Se precisar de mais detalhe do seu sistema: