Do Zero ao Assistente de IA em 5 Minutos
Escolha sua plataforma e siga o passo a passo. Você vai estar conversando com sua IA rapidinho.
Instalando no macOS
O jeito mais rápido de começar. Precisa de Node.js 18+.
Instale o OpenClaw
npm install -g openclawRode o Assistente de Setup
Vai te guiar pela configuração de API key e ajustes básicos.
openclaw initInicie o Gateway
O gateway é o serviço de background do OpenClaw que cuida de todas as conexões.
openclaw gateway startDiga Oi!
openclaw chat "Hello! What can you do?"Instalando no Windows
O OpenClaw roda muito bem no Windows via WSL2 (recomendado) ou Node.js nativo.
Configure o WSL2 (Recomendado)
Se não tem WSL2 instalado, abra o PowerShell como Admin e rode:
wsl --installReinicie o computador após a instalação.
Instale Node.js no WSL
Abra seu terminal WSL (Ubuntu) e instale Node.js:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejsInstale o OpenClaw
npm install -g openclawConfigure e Inicie
openclaw init
openclaw gateway start
openclaw chat "Hello!"Instalando no Linux
Funciona em qualquer distro com Node.js 18+. Perfeito pra servidores!
Instale Node.js (se necessário)
"comment"># Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
"comment"># Arch
sudo pacman -S nodejs npmInstale o OpenClaw
npm install -g openclawConfigure e Inicie
openclaw init
openclaw gateway startTeste
openclaw chat "Hello! What can you do?"Instalando com Docker
Ótimo pra isolamento e deploy fácil. Funciona onde Docker funciona.
Baixe a Imagem
docker pull openclaw/openclaw:latestRode o Setup
docker run -it \
-v openclaw-config:/home/openclaw/.openclaw \
openclaw/openclaw:latest initInicie o Gateway
docker run -d \
--name openclaw \
--restart unless-stopped \
-v openclaw-config:/home/openclaw/.openclaw \
openclaw/openclaw:latest gateway startConverse
docker exec -it openclaw openclaw chat "Hello!"Deploy na Cloud
Deploy com um clique pra disponibilidade 24/7.
Pegue Sua API Key
O OpenClaw precisa de uma API key do seu provedor de IA preferido.
Solução de Problemas
Problemas comuns e como resolver.
Command not found: openclaw
Make sure npm's global bin directory is in your PATH. Try:
npm config get prefixAdd the returned path + /bin to your shell's PATH variable.
Gateway won't start
Check if the port is already in use. The gateway runs on port 3000 by default.
lsof -i :3000 # macOS/Linux
netstat -ano | findstr :3000 # WindowsYou can also try restarting: openclaw gateway restart
API key not working
Verify your API key is correctly set:
openclaw config showMake sure there are no extra spaces. You can reset it with openclaw init.
WhatsApp QR code not appearing
The WhatsApp QR code is shown in the terminal. Make sure you run the command in a terminal that supports QR display. If issues persist, see the official WhatsApp docs.
Ainda com problemas?
🎉 Tudo Pronto!
Agora que o OpenClaw tá rodando, veja o que fazer em seguida: