Como Instalar o OpenClaw em Mac, Windows e Linux (Guia 2026)

OpenClaw roda em quase qualquer máquina moderna. Este guia cobre instalação em Mac, Windows, Linux e Raspberry Pi 5. Tempo total: cerca de 15-20 minutos se você já tem os pré-requisitos.

Pré-requisitos comuns a todas as plataformas

• Node.js 20+ (instalado via nvm é a forma mais limpa)
• Git pra clonar repositórios
• Uma API key de algum LLM — Claude (Anthropic), GPT-5 (OpenAI), Gemini (Google), ou DeepSeek
• Cerca de 2GB de espaço em disco pra deps e cache de modelos
• Conexão de internet estável — o agente conversa com a API do LLM o tempo todo

Instalação no Mac (macOS 13+)

Mac é a plataforma mais bem suportada (Steinberger desenvolveu no Mac):

# Instale Homebrew se ainda não tem
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Instale Node.js via nvm (mais limpo que brew install node)
brew install nvm
mkdir ~/.nvm
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/usr/local/opt/nvm/nvm.sh" ] && . "/usr/local/opt/nvm/nvm.sh"' >> ~/.zshrc
source ~/.zshrc
nvm install 20
nvm use 20

# Instale OpenClaw
npm install -g @openclaw/cli

# Verifique
openclaw --version

Se aparecer "permission denied" no npm install, NÃO use sudo. Use a configuração do nvm pra instalar packages globais sem root.

Instalação no Windows (Windows 10+/11)

Windows tem duas opções: instalação nativa ou WSL2. Recomendamos WSL2 pra menos dor de cabeça.

Opção 1 — WSL2 (recomendada)

# PowerShell como Admin
wsl --install -d Ubuntu

# Reinicie. Depois dentro do Ubuntu (WSL):
sudo apt update && sudo apt install -y curl git
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
npm install -g @openclaw/cli

Opção 2 — Windows nativo

Instale Node.js do node.js.org (LTS 20). Depois no PowerShell:

npm install -g @openclaw/cli

Algumas skills podem dar problema no Windows nativo (paths diferentes). Se tiver problemas, mude pra WSL2.

Instalação no Linux (Ubuntu/Debian/Arch)

Ubuntu/Debian:

sudo apt update && sudo apt install -y curl git
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
npm install -g @openclaw/cli

Arch:

sudo pacman -S nodejs npm git
npm install -g @openclaw/cli

Instalação no Raspberry Pi 5

Pi 5 (8GB de RAM) funciona surpreendentemente bem como host de bot — consumo de energia baixo, ideal pra deixar 24/7. Pi 4 também funciona, mas mais lento. Pi 3 e anteriores: esquece.

# No Raspberry Pi OS (64-bit)
sudo apt update && sudo apt install -y curl git
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
npm install -g @openclaw/cli

Considerações pro Pi:

• Use SSD em vez de SD card — vida útil muito maior, e leitura de logs mais rápida
• Configure cooling — Pi 5 esquenta em uso contínuo
• UPS pra não morrer em queda de luz (impacta produção)

Configuração inicial

Depois de instalado, configure pelo menos uma API key:

openclaw config set llm.provider anthropic
openclaw config set llm.api_key sk-ant-... # sua key aqui

# Verifique
openclaw chat "olá, está funcionando?"

Se voltar resposta, está OK.

Primeira skill — apenas pra testar

Antes de qualquer skill séria, instale uma trivial pra testar o sistema:

# Skill básica oficial
openclaw skill install @openclaw/skill-files

# Teste
openclaw chat "liste os arquivos do meu Desktop"

NUNCA instale skills do ClawHub sem auditar o código primeiro. Veja como identificar skill maliciosa.

Troubleshooting comum

• "command not found: openclaw" — npm global path não está no PATH. Veja npm config get prefix e adicione /bin ao seu PATH.
• "ETIMEDOUT" ao chamar API — provavelmente firewall/proxy. Configure variáveis HTTP_PROXY/HTTPS_PROXY se aplicável.
• "rate limit exceeded" — sua key tem limite baixo. Compre créditos ou troque pra modelo mais barato (DeepSeek por exemplo).
• "context window exceeded" — você está mandando contexto demais. Use modelo com janela maior ou divida sua tarefa.
• Versão antiga após upgrade — npm cache clean --force && npm install -g @openclaw/cli

Próximos passos

• Entenda como skills funcionam antes de instalar mais.
• Hardening em 12 passos antes de qualquer dinheiro real.
• Considere um VPS em vez de rodar local 24/7.

Instalado é o passo fácil. Operar com segurança é o trabalho real. 🦞