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.
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)
| # | Etapa | Tempo | Status |
|---|---|---|---|
| 1 | Node.js instalado | 2 min | ⬜ |
| 2 | OpenClaw instalado | 1 min | ⬜ |
| 3 | Wizard configurado | 1 min | ⬜ |
| 4 | Canal conectado | 1 min | ⬜ |
🎯 Meta: 5 minutos do início ao “Olá, mundo!”
🚀 Primeiro Dia com OpenClaw?
Instalou com sucesso? Siga o guia completo do primeiro dia:
Configure memória, personalidade e suas primeiras automações em 15 minutos.
📍 Navegação Rápida: Instalação Local · Canais (WhatsApp/Telegram) · Testar · Próximos Passos · Troubleshooting
🤝 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 →
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
| Cloud | RAM | Custo | Guia | |
|---|---|---|---|---|
| Recomendado | Oracle Cloud | 12GB | $0/mês | Tutorial completo |
| GCP Free Tier | 0.6GB | $0/mês | Tutorial completo |
Gratuito por 12 Meses
| Cloud | RAM | Custo após | Guia |
|---|---|---|---|
| AWS Free Tier | 1GB | ~$10/mês | Tutorial completo |
Opções Pagas (Mais Simples)
| Cloud | RAM | Custo | Guia |
|---|---|---|---|
| DigitalOcean | 1GB+ | $6/mês | Tutorial completo |
| Qualquer VPS | Varia | Varia | Guia 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 negada → Veja o fix abaixo (30 segundos)
- command not found → Node.js não está no PATH — reinstale acima
- Outro erro →
npm cache clean --forcee tente novamente
Requisitos
| Requisito | Detalhes |
|---|---|
| Node.js | Versão 22+ (recomendado: 24 LTS) — instale com nvm |
| Sistema | macOS, Linux, ou Windows via WSL2 |
| API Key | Anthropic (Claude) ou OpenAI |
🐧 Ubuntu/Debian
Use nvm (evita problemas de permissão):
nvm install 24 && nvm use 24
📦 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
sudoou 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:
- Gateway — Servidor local que processa suas mensagens
- Autenticação — Conecta com Claude ou GPT-4
- Canais — WhatsApp, Telegram, Discord, Slack…
- 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.
WhatsApp (mais popular) ⭐
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
- Abra @BotFather no Telegram
- Envie
/newbote siga as instruções - Copie o token que ele gerar
- 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:
- Verifique:
openclaw gateway status→ Deve mostrar “running” - Veja os logs:
openclaw gateway logs -f - 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 min | Primeira conversa no WhatsApp | Você acabou de fazer isso! ✅ |
| 15 min | Criar personalidade única | Editar SOUL.md → |
| 25 min | Configurar lembretes | Peça: “Me lembre de X em 30 minutos” |
| 30 min | Resumir um PDF ou link | Envie um link e peça resumo |
| 45 min | Bot respondendo em grupo | Adicione o bot a um grupo |
| 60 min | Primeira automação útil | Ver 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:
🚀 Começando Agora: O Que Fazer Depois de Instalar → ⭐ Seu Primeiro Bot (Tutorial) → Guia do Primeiro Dia →
🎯 Mais Popular: Pós-Instalação: Próximos Passos → Personalizar com SOUL.md →
🔌 Integrações: Discord · Slack · Skills
💼 Para Negócios: Chatbot WhatsApp 24/7 →
💡 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
- Feche outros dispositivos WhatsApp Web
- Reinicie o gateway:
openclaw gateway restart - Escaneie rapidamente (30 segundos)
- 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
- Troubleshooting Completo — Todas as soluções
- Discord — Comunidade ativa
- GitHub Issues — Reportar bugs
🎉 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:
- Chatbot WhatsApp para Empresas — Atenda clientes 24/7
- IA para MEI: Funcionário Virtual — Faça mais com menos
- 20 Casos de Uso Reais — Inspiração prática
🏠 Para Uso Pessoal
Organize sua vida e automatize tarefas:
- Personalizar com SOUL.md — Dê personalidade ao seu assistente
- Configurar Memória — Contexto persistente
- Automação Residencial com IA — Casa inteligente
🔌 Integrações e Canais
Conecte o OpenClaw onde você trabalha:
- Configurar Discord — Bot para seu servidor
- Configurar Slack — Integração com workspace
- Telegram Avançado — Guia técnico completo
- Gmail + WhatsApp — Automação de emails
- Google Calendar + WhatsApp — Agendamentos automáticos
- Ver todos os 80+ guias de conexão →
👨💻 Para Desenvolvedores
Leve ao próximo nível:
- Criar Skills Personalizadas — Expanda funcionalidades
- Explorar Skills Prontas — Comunidade de plugins
- OpenClaw + Home Assistant — Integração IoT
🌟 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
📚 Leia Também
Artigos populares da comunidade:
- Pós-Instalação: 7 Passos Essenciais — Configure tudo em 30 min
- OpenClaw vs ChatGPT: Qual Escolher?
- Segurança OpenClaw: API Keys, Permissões e LGPD
- Erros Comuns e Soluções
- Deploy no Fly.io Grátis — 24/7 na nuvem
- Criar Skills: Tutorial Completo
- 7 Frameworks de Agentes IA em 2026
🍳 Automações Prontas
Não sabe por onde começar? Copie uma receita pronta:
- 49 Receitas de Automação → — Automações prontas para copiar e usar
- Casos de Uso por Indústria → — E-commerce, saúde, educação, finanças
- O que é OpenClaw? → — Guia completo para quem está chegando
- Glossário de IA → — Termos técnicos explicados em português
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:
- GitHub Issues — Para bugs técnicos
- Troubleshooting Completo — Guia de referência
🎯 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.
👉 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 agora | Tempo |
|---|---|---|
| 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:
| ✓ | Etapa | Status |
|---|---|---|
| ☐ | OpenClaw instalado (openclaw --version funciona) | Pendente |
| ☐ | Gateway rodando (openclaw gateway status) | Pendente |
| ☐ | Canal conectado (WhatsApp/Telegram/Discord) | Pendente |
| ☐ | Primeira mensagem enviada e recebeu resposta | Pendente |
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.
3️⃣ Entre na Comunidade
Tire dúvidas, compartilhe ideias e veja o que outros estão fazendo.
❌ Problemas? Não Desista!
Algo deu errado? A maioria dos problemas se resolve em menos de 2 minutos:
- Diagnóstico rápido:
openclaw doctor(identifica problemas automaticamente) - Troubleshooting completo: /troubleshooting/ ← Resolve 95% dos casos
- Ajuda humana: Discord ← Resposta em minutos
Erros mais comuns:
Instalar OpenClaw no Linux: Ubuntu, Debian, Arch (Guia 2026)
Comandos de instalação do OpenClaw para Ubuntu, Debian, Fedora, Arch Linux e outras distros. Inclui systemd e …
Instalar OpenClaw no macOS: Guia Completo 2026
Passo a passo para instalar o OpenClaw no Mac (Intel e Apple Silicon M1/M2/M3). Comandos prontos para copiar no …
Instalar OpenClaw no Windows: Guia Completo 2026
Passo a passo para instalar o OpenClaw no Windows 10/11 usando WSL2. Inclui troubleshooting para erros comuns e …
OpenClaw + Docker: Instale em 2 Minutos com docker-compose (2026)
Instale OpenClaw via Docker em 2 minutos. docker-compose.yml pronto para copiar, volumes persistentes, variáveis de …