Como instalar e rodar o OpenClaw na sua máquina (passo a passo do zero à primeira conversa)

Fala aí, beleza? O OpenClaw tá em todo canto agora, e a pergunta que mais chega aqui não é "o que ele faz", é "como eu coloco isso pra rodar na minha máquina"

Antes de sair colando comando no terminal, um contexto rápido: o OpenClaw é open source sob licença MIT, criado pelo desenvolvedor austríaco Peter Steinberger, e hoje é tocado pela OpenClaw Foundation, uma 501(c)(3) independente anunciada em 8 de julho de 2026 por Dave Morin e pelo próprio Steinberger, com time em tempo integral

A OpenAI patrocina o projeto, não é dona dele: a lista de patrocinadores inclui também NVIDIA, Microsoft e Tencent

E se você procurou por Clawdbot ou Moltbot e se perdeu, é o mesmo projeto: o Clawdbot virou Moltbot em 27 de janeiro de 2026, depois de uma reclamação de marca da Anthropic, e três dias depois passou a se chamar OpenClaw

Aqui a gente vai do zero até a primeira conversa funcionando, só com o que dá pra confirmar na documentação oficial

Bora?

O que você precisa antes de instalar o OpenClaw

A lista é curta, mas é justamente aqui que mora metade dos problemas que aparecem depois

Formação Recomendada

Formação Agentes de IA

Domine a criação de Agentes de IA e Venda para Empresas

• 402 aulas
• 32 projetos
• 38h 19min

Conhecer formação

Node.js numa versão suportada

As versões suportadas são Node 22.22.3+, Node 24.15+ ou Node 25.9+

Repara no sinal de mais: são pisos de cada linha, e não versões exatas. Por isso o Node 26, mais novo que o 25.9, entra nessa faixa

E se liga nisso: o Node 23 NÃO é suportado

O Node 26 é justamente o runtime padrão e recomendado, e é exatamente o que o instalador provisiona quando não existe Node nenhum na máquina

A doc justifica: com Node 26 o Gateway inicia mais rápido e usa menos memória que no Node 24

Chave de API de um provedor de modelo

É pré-requisito pra concluir o setup: Anthropic, OpenAI, Google, entre outros

O projeto é gratuito, o que custa é o consumo da chave

Máquina

A documentação traz os números no contexto de rodar o Gateway numa VM: mínimo absoluto de 1 vCPU e 1 GB de RAM, e 2 GB+ recomendado se você for usar múltiplos canais, automação de navegador ou ferramentas de mídia

No Windows

O instalador via PowerShell exige PowerShell 5+

Passo a passo: instalar o OpenClaw e chegar na primeira conversa

A doc oficial fala em cerca de 5 minutos pra instalar, rodar o onboarding e conversar

E ela mesma avisa que login no provedor, pareamento de canal, instalação de daemon, downloads, skills ou plugins podem esticar esse tempo, então não fica bravo se demorar mais 😀

1. Rodar o instalador oficial

No macOS, Linux e WSL2:

curl -fsSL https://openclaw.ai/install.sh | bash

No Windows, pelo PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

O fluxo é automático: ele detecta o sistema operacional, provisiona o Node, instala o OpenClaw e já lança o onboarding

Ou seja: se tudo correr bem, o assistente do passo 3 já vai abrir sozinho na sua frente

Erro comum deste passo: achar que "tenho Node instalado, tá tudo certo". Se o que tá aí é Node 23, não é versão suportada, e você vai apanhar sem entender o motivo

2. Alternativa por npm

Se você prefere o caminho de sempre, o pacote existe no npm com o nome openclaw:

npm install -g openclaw@latest

Se você já conhece qualquer instalação global de CLI por npm, é exatamente a mesma coisa aqui, sem mistério

3. O onboarding (que o instalador já abre pra você)

Como o instalador lança o assistente no fim, na maioria das vezes você não precisa digitar nada aqui, é só seguir as perguntas na tela

O comando existe pra chamar esse mesmo assistente na mão, quando você quiser rodar de novo ou usar uma das variantes:

openclaw onboard

Existem variantes documentadas: openclaw onboard --classic (auth por provedor, canais, skills, Gateway remoto, importação), openclaw setup (mesmo fluxo) e openclaw onboard --modern, que é um alias de compatibilidade

O assistente cobre provedor de modelo, chave de API, workspace, Gateway e recursos opcionais

Esse workspace que ele configura tem um lugar padrão no disco, e eu volto nisso lá embaixo, porque é o que você vai querer copiar quando trocar de máquina

Erro comum deste passo: pular o setup de modelo pra "resolver depois". Aí aparece o aviso Model auth missing, a TUI abre bonitinha e não envia nada. O agente fica mudo

Correção:

openclaw configure --section model

4. Retomar o que você pulou

Passos opcionais podem ser pulados e retomados depois:

openclaw configure

5. Subir o Gateway e abrir a Control UI

A porta padrão do Gateway é a 18789

openclaw gateway --port 18789

Se quiser log detalhado pra enxergar o que tá acontecendo:

openclaw gateway --port 18789 --verbose

Com o Gateway no ar, a Control UI fica em http://127.0.0.1:18789/

Tome cuidado aqui! A Control UI dá controle total do agente, e o aviso é da própria documentação: nunca exponha essa porta à internet pública sem autenticação

Os erros que travam a maioria (e como resolver)

Porta ocupada

Sintoma: another gateway instance is already listening ou o clássico EADDRINUSE

Causa provável: já tem um Gateway rodando, ou um túnel SSH segurando a porta

Correções documentadas:

openclaw doctor --fix

openclaw gateway install --force

Nesse segundo caso, reinicie o serviço depois

Ou simplesmente escolhe outra porta:

openclaw gateway --port <porta>

Quando você quer ver quem tá segurando a porta

openclaw gateway status --deep

openclaw doctor --deep

Os dois mostram os clientes TCP ativos na porta do Gateway, com PID e linha de comando quando o sistema permite

Agente mudo

Aquele Model auth missing de novo: a interface abre e nada sai

É setup de modelo faltando, resolve com openclaw configure --section model

Node incompatível

Faixa suportada: 22.22.3+, 24.15+ ou 25.9+, com o Node 26 (o que o instalador provisiona) dentro desse último degrau

O buraco no meio é o Node 23, que não é suportado

Como prevenir tudo isso

Roda o openclaw doctor antes de abrir chamado com você mesmo haha

Ele verifica colisão na porta padrão 18789 e já aponta as causas prováveis, tipo Gateway já rodando ou túnel SSH

Windows, WSL2 ou Docker: qual caminho de instalação escolher

No Windows são três caminhos documentados, e eles não são equivalentes

Se o seu fluxo depende de coisa que nasceu no mundo Linux, o WSL2 é o caminho que a doc marca como mais compatível

E tem um detalhe legal do instalador PowerShell: se faltar Node, ele tenta instalar via winget, depois Chocolatey, depois Scoop

Não achou gerenciador de pacotes nenhum? Ele baixa o zip oficial do Node.js 26 pra %LOCALAPPDATA%\OpenClaw\deps\portable-node e adiciona ao PATH do processo e do usuário

Ou seja: ele se vira sozinho 🙂

Tem ainda o caminho Docker, com imagens oficiais voltadas a gateways standalone baseados em OCI e a usuários genéricos de Docker

Se esse é o seu cenário, dá pra ir mais fundo em instalar o OpenClaw com Docker Compose com sandbox e hardening, que é papo de outro post

Rodando com modelo local: o que dá pra usar sem gastar com API

Aqui entra a parte que eu testei na prática

No vídeo eu instalo o OpenClaw direto no meu PC com Windows, em vez de subir numa VPS, justamente pra não ter custo de servidor

Copiei o comando de instalação do sistema operacional, colei no terminal e o setup foi rodando passo a passo

Durante o onboarding eu pulei as etapas de canal de integração, skills e configurações de memória, deixando pra configurar depois

No fim ele pediu pra escolher a opção de conversa com o bot, e eu adiei, porque ainda não tinha modelo local instalado na máquina

Aí instalei o Ollama pelo instalador do site (aquele next, next e finish) e confirmei que funcionou rodando o comando de versão no terminal

Baixei o modelo, apontei o OpenClaw pra ele, e a conversa subiu apontando pro modelo local. Testei com um oi e depois perguntei pro bot qual LLM ele tava usando: ele identificou certinho o modelo que eu tinha instalado

O que rodou bem na minha máquina foi o gpt-oss 20B

Na lista de modelos sugeridos tinha opção de 120 bilhões de parâmetros, e essa eu não conseguiria rodar aqui

E é essa a lição honesta: quanto mais parâmetros, mais pesado, e sem uma GPU boa a resposta demora tanto que perde a graça

A dica que eu dou no vídeo é pegar as specs da sua máquina (placa de vídeo e RAM) e pedir pra uma IA recomendar qual modelo cabe aí, em vez de baixar o maior da lista e descobrir na dor

Um aviso importante: modelo sem suporte a tools não rodou pra mim nesse fluxo

E vou ser transparente contigo: a documentação oficial lista chave de API de provedor como pré-requisito pra concluir o setup, então esse caminho de modelo local é o que funcionou no meu teste, não uma configuração que eu vi documentada como suportada

O que a licença garante é outra coisa: o OpenClaw é livre e open source sob MIT, então o custo real não tá no software, tá no consumo da chave do provedor que você escolher

Onde ficam seus arquivos e como levar o setup pra outra máquina

Depois que tudo tá rodando vem a pergunta prática: cadê minhas coisas?

O estado fica em $OPENCLAW_STATE_DIR, que por padrão é ~/.openclaw

O workspace padrão (aquele que o assistente configura lá no passo 3) fica em ~/.openclaw/workspace

E isso resolve a migração de um jeito bem direto: pra levar o setup pra outra máquina sem refazer o onboarding, você instala o OpenClaw na máquina nova, copia $OPENCLAW_STATE_DIR e copia o workspace

Só isso

É o cenário perfeito pra quem configura tudo no notebook com calma e depois quer subir numa VM sem repetir o assistente inteiro

Próximo passo depois da primeira conversa

Com o Gateway no ar e o provedor configurado, você já tem o essencial funcionando

O caminho natural daqui é explorar canais, recursos opcionais e a Control UI, sempre local, e ir ligando as skills do ClawHub no OpenClaw conforme a necessidade aparecer

E repetindo o aviso que vale mais que qualquer dica de produtividade: não exponha a porta 18789 à internet pública sem autenticação

Pra acompanhar a evolução do projeto, a fonte é o repositório oficial do OpenClaw

Qualquer coisa que mudar de verdade vai aparecer lá antes de aparecer em qualquer thread de rede social

Até o próximo post!