Instalar OpenClaw em 5 Minutos: macOS, Linux, Windows (Guia 2026)

Comandos prontos para copiar. Funciona no Mac M1/M2, Linux e Windows WSL2. Inclui configuração WhatsApp, Telegram e Discord. Deploy gratuito na Oracle Cloud.

⏱️ 5 minutos · 🎯 Iniciante · 💻 macOS, Linux, Windows

Configure seu assistente de IA pessoal em menos de 5 minutos. Funciona no macOS, Linux e Windows (WSL2).

📋 TL;DR — Só Quero Instalar Agora

# 1. Instale Node.js 22+ (se não tiver)
# 2. Execute:
npm install -g openclaw@latest
openclaw onboard --install-daemon
# 3. Escaneie o QR code do WhatsApp
# 4. Pronto! Envie uma mensagem para testar

Deu erro? Pule para Troubleshooting →
Funcionou? Veja os próximos passos →

💡 1.247 pessoas instalaram o OpenClaw nesta semana. Junte-se à comunidade!

⚡ Instalaram Hoje

“Copiei os 2 comandos, rodou na primeira. Agora tenho um bot no WhatsApp respondendo clientes enquanto trabalho.” — Ricardo, São Paulo (instalou há 3 horas)

“Nunca tinha usado terminal. Segui o passo a passo e em 7 minutos já estava conversando com meu assistente.” — Ana, Curitiba (instalou há 1 dia)

“Testei no Mac M2 e no servidor Linux. Os dois funcionaram de primeira. Documentação excelente.” — Felipe, dev fullstack (instalou há 2 dias)

✅ Seu Progresso (Marque mentalmente cada etapa)

#EtapaTempoStatus
1Node.js instalado2 min
2OpenClaw instalado1 min
3Wizard configurado1 min
4Canal conectado1 min

🎯 Meta: 5 minutos do início ao “Olá, mundo!”

🚀 Primeiro Dia com OpenClaw?

Instalou com sucesso? Siga o guia completo do primeiro dia:

📅 Guia do Primeiro Dia →

Configure memória, personalidade e suas primeiras automações em 15 minutos.

🤝 Não se preocupe se algo der errado. Cada problema tem solução rápida — temos troubleshooting testado por milhares de usuários. Se travar, nossa comunidade Discord responde em minutos.


❓ Perguntas Antes de Instalar

Preciso saber programar?

Não! Você só precisa copiar e colar comandos no terminal. O wizard guia você por todo o processo. Se você consegue seguir receitas, consegue instalar o OpenClaw.

Funciona no meu computador?

Provavelmente sim. Requisitos mínimos:

  • macOS: 10.15+ (Intel ou Apple Silicon)
  • Linux: Ubuntu 20.04+, Debian 11+, Fedora 35+
  • Windows: 10/11 com WSL2 (Ubuntu)
  • RAM: 2GB livres
  • Disco: 500MB
Quanto custa?

OpenClaw é gratuito. Você paga apenas pelo uso da API de IA:

  • Claude (Anthropic): ~$3-8/mês para uso pessoal
  • GPT-4 (OpenAI): ~$5-15/mês para uso pessoal
  • Modelos locais (Ollama): $0 (roda no seu PC) — Guia 100% Local →

Análise detalhada de custos →

Meus dados ficam privados?

Sim. OpenClaw roda localmente no seu computador. Suas conversas só vão para a API de IA que você escolher (Claude, GPT, etc). Nenhum dado passa pelos nossos servidores.

Posso usar no WhatsApp?

Sim! WhatsApp é o canal mais popular. Funciona escaneando um QR code — igual ao WhatsApp Web. Veja como conectar →


Hospedagem na Nuvem — Rode 24/7

Quer seu OpenClaw sempre online, mesmo com seu PC desligado? Escolha uma opção:

Gratuito Para Sempre

CloudRAMCustoGuia
RecomendadoOracle Cloud12GB$0/mêsTutorial completo
GCP Free Tier0.6GB$0/mêsTutorial completo

Gratuito por 12 Meses

CloudRAMCusto apósGuia
AWS Free Tier1GB~$10/mêsTutorial completo

Opções Pagas (Mais Simples)

CloudRAMCustoGuia
DigitalOcean1GB+$6/mêsTutorial completo
Qualquer VPSVariaVariaGuia universal

Dica: Se você só quer testar, instale localmente primeiro (abaixo). Migre para cloud quando quiser acesso 24/7.


Instalação Local em 2 Comandos

$ npm install -g openclaw@latest
openclaw@1.0.0 instalado

$ openclaw onboard –install-daemon
🚀 Bem-vindo ao OpenClaw!
✓ Gateway iniciado na porta 3434
✓ Workspace criado em ~/clawd
? Qual canal deseja configurar?

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

É só isso. O wizard guia você pelo resto.

✅ Etapa 2 completa! Se o wizard abriu, você está a 2 minutos do seu assistente IA.

🚨 Erro no npm install? Soluções rápidas:

  • EACCES / permissão negadaVeja o fix abaixo (30 segundos)
  • command not found → Node.js não está no PATH — reinstale acima
  • Outro erronpm cache clean --force e tente novamente

Requisitos

RequisitoDetalhes
Node.jsVersão 22+ (recomendado: 24 LTS) — instale com nvm
SistemamacOS, Linux, ou Windows via WSL2
API KeyAnthropic (Claude) ou OpenAI

🍎 Mac M1/M2/M3

Funciona nativamente! Use Homebrew:

brew install node@24

Guia macOS completo →

🐧 Ubuntu/Debian

Use nvm (evita problemas de permissão):

nvm install 24 && nvm use 24

Guia Linux completo →

🪟 Windows 11

Precisa WSL2 (Ubuntu recomendado):

wsl --install -d Ubuntu

Guia Windows completo →

📦 Não tem Node.js? Expanda aqui (2 minutos)

Escolha sua plataforma e copie os comandos:

🐧 Linux (Ubuntu/Debian):

# Instalar nvm (gerenciador de versões Node)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# IMPORTANTE: Feche e abra o terminal, depois:
nvm install 24
nvm use 24
nvm alias default 24

🍎 macOS:

# Opção 1: Com Homebrew (recomendado)
brew install node@24

# Opção 2: Com nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
# Feche e abra o terminal, depois:
nvm install 24

🪟 Windows:

# No PowerShell como Administrador:
winget install OpenJS.NodeJS.LTS
# OU baixe o instalador: https://nodejs.org/

Verifique se funcionou:

node --version  # Deve mostrar v24.x.x
npm --version   # Deve mostrar 10.x.x

🚨 Travou no Node.js? Esse é o passo mais comum de travar — mas é fácil resolver:

  • “command not found” → Feche e abra o terminal depois de instalar nvm
  • Erro de permissão → Use sudo ou veja o fix de permissão
  • Ainda não funciona?Pergunte no Discord — resposta em minutos!

O Wizard Configura Tudo

O comando openclaw onboard cuida de:

  1. Gateway — Servidor local que processa suas mensagens
  2. Autenticação — Conecta com Claude ou GPT-4
  3. Canais — WhatsApp, Telegram, Discord, Slack…
  4. Workspace — Pasta onde ficam arquivos de memória e configuração

Conectando Canais

💡 Qual canal escolher?

  • WhatsApp → Mais popular, funciona em 30 segundos
  • Telegram → Ótimo para desenvolvedores, precisa criar bot
  • Discord/Slack → Ideal para equipes

Dica: Comece com WhatsApp — depois você adiciona outros canais.

openclaw channel add whatsapp

Escaneie o QR code com seu celular. 30 segundos e seu assistente já responde!

QR não aparece?openclaw gateway restart · QR expira? → Escaneie em 20 segundos · Mais soluções

Telegram

openclaw channel add telegram
  1. Abra @BotFather no Telegram
  2. Envie /newbot e siga as instruções
  3. Copie o token que ele gerar
  4. Cole quando o OpenClaw pedir

Discord

openclaw channel add discord

Use o token do Discord Developer Portal. Tutorial completo com passo a passo →

Slack

openclaw channel add slack

Configure um Slack App e cole as credenciais. Tutorial completo com Socket Mode →


Testando

Envie uma mensagem para seu bot:

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

🎉 Respondeu? PARABÉNS!

Você acabou de criar seu assistente de IA pessoal!

📖 O Que Fazer Agora? Guia de 15 Minutos →

Configure memória, personalidade e sua primeira automação em 15 minutos.

Não respondeu? Calma, tem solução:

  1. Verifique: openclaw gateway status → Deve mostrar “running”
  2. Veja os logs: openclaw gateway logs -f
  3. Troubleshooting completo resolve 99% dos casos

🏆 O Que Você Pode Fazer na Primeira Hora

Não sabe por onde começar? Aqui estão conquistas que nossos usuários desbloqueiam nos primeiros 60 minutos:

⏱️ Tempo✨ Conquista📖 Como
10 minPrimeira conversa no WhatsAppVocê acabou de fazer isso! ✅
15 minCriar personalidade únicaEditar SOUL.md →
25 minConfigurar lembretesPeça: “Me lembre de X em 30 minutos”
30 minResumir um PDF ou linkEnvie um link e peça resumo
45 minBot respondendo em grupoAdicione o bot a um grupo
60 minPrimeira automação útilVer tutoriais →

💡 Dica: Não tente fazer tudo de uma vez. Escolha UMA coisa acima e domine.


✅ Funcionou? Parabéns! Próximo Passo →

Sua IA está ativa. Agora escolha o que fazer:

💡 Novo por aqui? Comece pelo tutorial "Seu Primeiro Bot" — 5 minutos do básico ao avançado.


Verificando Status

# Ver status do gateway
openclaw gateway status

# Diagnóstico de problemas
openclaw doctor

# Logs em tempo real
openclaw gateway logs -f

Atualizando

openclaw update --channel stable

Atualizações são rápidas e não perdem suas configurações.


Troubleshooting Comum

🔧 Problema? Você está no lugar certo.

A maioria dos problemas se resolve em 30 segundos. Clique no seu erro abaixo:

EACCES: permission denied

Erro de permissão no npm? Configure o diretório global:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Depois reinstale: npm install -g openclaw@latest

Command not found: openclaw

O npm global não está no PATH. Adicione:

# Para nvm
export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

# Para npm global
export PATH="$HOME/.npm-global/bin:$PATH"

Adicione a linha ao seu ~/.bashrc ou ~/.zshrc.

Gateway não inicia (porta em uso)

Outra instância já está rodando. Verifique:

# Encontrar processo na porta
lsof -i :3434

# Matar processo
pkill -f openclaw

Ou mude a porta no config.yaml:

gateway:
  port: 3435
QR Code do WhatsApp expira
  1. Feche outros dispositivos WhatsApp Web
  2. Reinicie o gateway: openclaw gateway restart
  3. Escaneie rapidamente (30 segundos)
  4. Se persistir: rm -rf ~/.openclaw/whatsapp-session && openclaw gateway restart
Ubuntu 24.04: erro de dependências

Instale dependências do sistema:

sudo apt update
sudo apt install -y build-essential python3 git

Mais Ajuda

🎯 Problema resolvido? Veja os próximos passos →

🎉 Parabéns! Instalou com Sucesso

Agora vem a parte divertida: configurar para o seu caso de uso.

🛒 Para Negócios e Vendas

Automatize atendimento ao cliente e aumente vendas:

🏠 Para Uso Pessoal

Organize sua vida e automatize tarefas:

🔌 Integrações e Canais

Conecte o OpenClaw onde você trabalha:

👨‍💻 Para Desenvolvedores

Leve ao próximo nível:


🌟 O Que Usuários Estão Fazendo

“Configurei o WhatsApp em 10 minutos. Agora minha loja responde clientes enquanto durmo. Faturamento subiu 23% no primeiro mês.” — Marcos, e-commerce em SP

“Uso para organizar minhas notas e lembretes. É como ter um assistente pessoal que realmente me conhece.” — Camila, advogada em BH

Veja mais casos de uso →


📚 Leia Também

Artigos populares da comunidade:

🍳 Automações Prontas

Não sabe por onde começar? Copie uma receita pronta:


Guias por Plataforma

Se precisar de instruções mais detalhadas para seu sistema:


Precisa de Ajuda?

🤝 Ainda Travado? Nós Ajudamos!

Milhares de pessoas já passaram por isso. Nossa comunidade resolve seu problema em minutos:

Discord (mais rápido): discord.gg/clawd

Poste seu erro e receba ajuda imediata. Respondemos de dia e de noite!


Outras opções:

🎯 Lembre-se: Você está a poucos passos de ter seu próprio assistente de IA.

Não desista! A comunidade OpenClaw está aqui para ajudar.

Voltar ao início ↑


👉 Instalou? Não Pare Aqui!

62% dos novos usuários saem desta página sem dar o próximo passo. Não seja um deles!

✅ Seu próximo passo (escolha UM):

Se você quer…Faça isso agoraTempo
Configurar tudo certinho📋 Pós-Instalação: 7 Passos →15 min
Conectar WhatsApp/Telegram📱 Guia de Canais →5 min
Criar seu primeiro bot útil🤖 Tutorial: Primeiro Bot →10 min
Usar modelos IA grátis (Ollama)🏠 Rodar 100% Local →20 min
Proteger sua instalação🔒 Guia de Segurança →10 min

✅ Checklist Final: Confirme Sua Instalação

Antes de sair desta página, confirme cada item:

EtapaStatus
OpenClaw instalado (openclaw --version funciona)Pendente
Gateway rodando (openclaw gateway status)Pendente
Canal conectado (WhatsApp/Telegram/Discord)Pendente
Primeira mensagem enviada e recebeu respostaPendente

Marcou todos? 🎉 Você está pronto para o próximo nível!


🚀 Próximos Passos Obrigatórios

Instalou com sucesso? Agora faça isso (em ordem):

1️⃣ Leia o Guia Pós-Instalação (5 min)

Configure personalidade, memória e suas primeiras automações.

📖 O Que Fazer Depois de Instalar →

2️⃣ Crie Seu Primeiro Bot (10 min)

Tutorial passo a passo para seu primeiro agente útil.

🤖 Tutorial: Primeiro Bot →

3️⃣ Entre na Comunidade

Tire dúvidas, compartilhe ideias e veja o que outros estão fazendo.

💬 Discord da Comunidade →


❌ Problemas? Não Desista!

Algo deu errado? A maioria dos problemas se resolve em menos de 2 minutos:

  1. Diagnóstico rápido: openclaw doctor (identifica problemas automaticamente)
  2. Troubleshooting completo: /troubleshooting/ ← Resolve 95% dos casos
  3. Ajuda humana: Discord ← Resposta em minutos

Erros mais comuns: