Como Instalar o OpenClaw

⏱ 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)

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

Guia 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)

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

	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 --force e 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

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

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

openclaw channel add telegram

Abra @BotFather no Telegram
Envie /newbot e 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 →

** 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

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:

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

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

Veja mais casos de uso →

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.

Voltar ao início ↑

✅ 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.

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:

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 em 5 Minutos: macOS, Linux, Windows (Guia 2026)