Como instalar o OpenClaw — Guia completo de instalação para Windows, Mac e Linux

A instalação do OpenClaw leva cerca de 5 minutos. Você vai precisar de Node.js 22+, Git e 8 GB de RAM. O jeito mais rápido é um único comando npm install -g openclaw@latest seguido do assistente de configuração. Alternativamente, pule a instalação completamente com a hospedagem gerenciada do MyClaw.ai.

O que você precisa antes de instalar o OpenClaw

Antes de instalar o OpenClaw na sua máquina, reúna estes requisitos:

RequisitoMínimoRecomendadoRAM8GB16GBArmazenamento10GB20GBNode.jsv22v22+ (último LTS)SOWin 10 (WSL2) / macOS 12 / Ubuntu 20.04Última versão estável

Opção 1: Pular a instalação com hospedagem gerenciada

Não quer lidar com a instalação? O MyClaw.ai oferece hospedagem OpenClaw totalmente gerenciada — sua instância fica pronta em segundos sem nenhuma configuração:

• Configuração instantânea — Sem instalar, sem configurar, sem comandos no terminal
• Sempre rodando — Disponibilidade 24/7 sem precisar manter o computador ligado
• Atualizações automáticas — Sempre executando a versão mais recente do OpenClaw

Comece com o MyClaw.ai →

---

Opção 2: Hospedar o OpenClaw você mesmo

Existem duas formas de auto-hospedagem: a instalação global recomendada (mais fácil) ou compilar a partir do código-fonte (para desenvolvedores).

Recomendado: Instalação global

Essa é a forma mais rápida de colocar o OpenClaw para funcionar em qualquer plataforma:

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

O assistente de configuração guia você pela configuração do gateway, workspace, canais e skills. A flag --install-daemon configura um serviço em segundo plano (launchd no macOS, systemd no Linux) para que o OpenClaw rode de forma persistente.

Após a configuração, verifique sua instalação:

openclaw doctor

---

Alternativa: Compilar a partir do código-fonte

Se você prefere controle total ou deseja contribuir com o OpenClaw, pode compilar a partir do código-fonte. Siga os guias específicos para cada plataforma abaixo.

Instalar o OpenClaw no Windows

O WSL2 é fortemente recomendado para executar o OpenClaw no Windows. Instale o WSL2 primeiro e depois siga as instruções para Linux abaixo.

Se você ainda quiser executar nativamente no Windows:

Passo 1: Instalar os pré-requisitos

1. Baixe o Node.js v22+ (versão LTS)
2. Baixe o Git para Windows
3. Instale o pnpm — o gerenciador de pacotes preferido do OpenClaw
4. Reinicie o terminal após a instalação

Verifique as instalações:

node --version   # Deve ser v22 ou posterior
git --version
pnpm --version

Passo 2: Clonar o repositório do OpenClaw

Abra o PowerShell ou o Prompt de Comando e execute:

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Passo 3: Instalar e compilar

pnpm install
pnpm ui:build
pnpm build

Isso baixa todos os pacotes necessários e compila o projeto.

Passo 4: Executar o assistente de configuração

pnpm openclaw onboard --install-daemon

O assistente guia você pela configuração do OpenClaw, incluindo a configuração do modelo de IA, canais e workspace.

Instalar o OpenClaw no macOS

Passo 1: Instalar os pré-requisitos

A forma mais fácil é usando o Homebrew:

# Instalar o Homebrew se necessário
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Instalar Node.js e Git
brew install node git

# Instalar pnpm
brew install pnpm

Passo 2: Clonar e compilar

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Passo 3: Executar o assistente de configuração

pnpm openclaw onboard --install-daemon

Isso configura um serviço launchd para que o OpenClaw rode automaticamente em segundo plano.

Permissões do macOS

O OpenClaw pode solicitar permissões de acessibilidade para gravação de tela e recursos de voz. Quando solicitado, vá para:

Ajustes do Sistema > Privacidade e Segurança > Acessibilidade

Adicione seu aplicativo de terminal à lista permitida.

Instalar o OpenClaw no Linux (Ubuntu/Debian)

Passo 1: Instalar os pré-requisitos

# Atualizar o gerenciador de pacotes
sudo apt update

# Instalar Node.js 22 via NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Instalar Git
sudo apt install -y git

# Instalar pnpm
npm install -g pnpm

Passo 2: Clonar e compilar

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Passo 3: Executar o assistente de configuração

pnpm openclaw onboard --install-daemon

Isso configura um serviço de usuário systemd para que o OpenClaw rode de forma persistente em segundo plano.

Solução de problemas comuns de instalação

"pnpm install" falha com erros de permissão

No Linux/macOS, evite usar sudo com pnpm ou npm. Em vez disso, corrija as permissões:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Erro "Versão do Node não suportada"

O OpenClaw requer Node.js 22 ou posterior:

node --version

Se sua versão for mais antiga, baixe a mais recente em nodejs.org ou use o nvm para gerenciar versões:

nvm install 22
nvm use 22

Porta já em uso

Outro aplicativo está usando a mesma porta. Você pode:

• Parar o aplicativo em conflito
• Especificar uma porta diferente: openclaw gateway --port 18790

Dependências nativas ausentes

No Linux, você pode precisar de ferramentas de compilação adicionais:

sudo apt install build-essential

Executar a ferramenta de diagnóstico

O OpenClaw inclui um comando de diagnóstico integrado que verifica sua configuração:

openclaw doctor

Verificar sua instalação

Após instalar o OpenClaw, execute a ferramenta de diagnóstico para confirmar que tudo está funcionando:

openclaw doctor

Depois teste com um simples comando de agente:

openclaw agent --message "Olá, você está funcionando?"

Se o OpenClaw responder, sua instalação está completa.

Atualizar o OpenClaw

Para atualizar sua instalação do OpenClaw para a versão mais recente:

Se instalado globalmente:

openclaw update --channel stable

Se compilado a partir do código-fonte:

cd openclaw
git pull origin main
pnpm install
pnpm ui:build
pnpm build

Próximos passos

Agora que o OpenClaw está instalado:

• Leia o Guia de Primeiros Passos para aprender o uso básico
• Saiba mais sobre O que é o OpenClaw
• Explore as opções de hospedagem do OpenClaw para execução 24/7