Guia de instalação

Instale o OpenClaw

Escolha seu método preferido. Todos levam ao mesmo CLI.

checklist Requisitos do sistema

javascript Node.js

Node.js 22 ou superior (LTS recomendado)

computer OS

Windows 10+, macOS 12+ ou Linux (Ubuntu 20.04+, Debian 11+)

memory RAM

2 GB de RAM mínimo, 4 GB recomendado

hard_drive Disk

~500 MB de espaço em disco pra instalação e dependências

extension Optional

Opcional: Python 3.10+ (pra alguns skills), Git (pra compilar do fonte)

wifi Network

Conexão com a internet necessária pra chamadas de API de IA. Modelos locais via Ollama funcionam offline.

Scripts de uma linha que fazem tudo. Recomendado pra maioria. Tudo na documentação arrow_forward

Windows (PowerShell)

Execute o PowerShell como admin pra melhores resultados.

PS> curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd

macOS / Linux

Funciona no macOS e na maioria das distros Linux.

$ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

verified Verifique sua instalação

Rode esses comandos pra confirmar que o OpenClaw foi instalado corretamente.

1
$ openclaw --version

Deve mostrar o número da versão instalada (ex: v2026.3.12).

2
$ openclaw doctor

Roda uma verificação diagnóstica do seu ambiente: versão do Node.js, dependências, arquivos de config e conectividade.

3
$ openclaw onboard

Assistente interativo de configuração que te guia pelas chaves de API, conexões com plataformas de chat e configuração inicial.

settings Configuração inicial

Após a instalação, o assistente de onboard te guia pela configuração. Veja o que cada passo faz.

1

Escolha seu provedor de IA

Selecione Anthropic (Claude), OpenAI (GPT), Google (Gemini) ou um modelo local via Ollama. Você pode trocar de provedor a qualquer momento na config.

2

Adicione sua API key

Cole sua API key do painel do provedor. As chaves são armazenadas localmente no seu arquivo .env — nunca enviadas pra lugar nenhum exceto o provedor de IA.

3

Conecte uma plataforma de chat

Vincule WhatsApp (escaneie QR code), Telegram (cole o token do bot do @BotFather), Discord (cole o token do bot) ou qualquer outra plataforma suportada.

4

Envie uma mensagem de teste

Mande uma mensagem pro OpenClaw pelo seu app de chat conectado. Se ele responder, tá tudo certo. Tente: 'O que você pode fazer?'

.env — Toda configuração fica em ~/.openclaw/.env. Você pode editar esse arquivo diretamente pra trocar provedores, adicionar API keys ou ajustar configurações. Veja docs.openclaw.ai/configuration pra referência completa.

system_update_alt Atualizando o OpenClaw

Mantenha o OpenClaw atualizado pra ter os últimos recursos, integrações e correções de segurança. Como atualizar e migrar arrow_forward

npm
$ npm update -g openclaw@latest
pnpm
$ pnpm update -g openclaw@latest
Git
$ cd openclaw && git pull && pnpm install && pnpm run build
Docker
$ docker pull openclaw/openclaw:latest && docker restart openclaw

Confira o changelog em github.com/openclaw/openclaw/releases pra ver as novidades de cada versão.

delete_forever Desinstalar o OpenClaw

Se precisar remover o OpenClaw do seu sistema, siga os passos correspondentes ao método de instalação que você usou. Como desinstalar passo a passo arrow_forward

npm
$ npm uninstall -g openclaw
pnpm
$ pnpm remove -g openclaw
Git (Source)
$ rm -rf ~/openclaw
Docker
$ docker stop openclaw && docker rm openclaw && docker rmi openclaw/openclaw:latest

Remover dados do usuário (opcional)

Isso apaga todas as suas conversas, skills, configurações e chaves de API. Faça um backup do que precisar antes de continuar.

macOS/Linux $ rm -rf ~/.openclaw
Windows PS> rmdir /s /q %USERPROFILE%\.openclaw

build Solução de problemas

Problemas comuns e como resolver. Mais dicas pra resolver problemas arrow_forward

Precisa de ajuda?

Entre no nosso Discord pra suporte na instalação.

Fique por dentro

Receba novidades sobre recursos e integrações. Sem spam, cancele quando quiser.