Skip to main content

Instalação

Já seguiu Primeiros passos? Então está tudo pronto — esta página é para métodos alternativos de instalação, instruções específicas por plataforma e manutenção.

Requisitos do sistema

  • Node 22+ (o script de instalação irá instalá-lo se estiver ausente)
  • macOS, Linux ou Windows
  • pnpm apenas se você compilar a partir do código-fonte
No Windows, recomendamos fortemente executar o OpenClaw no WSL2.

Métodos de instalação

O script de instalação é a forma recomendada de instalar o OpenClaw. Ele cuida da detecção do Node, da instalação e da integração inicial em uma única etapa.

Installer script

Baixa a CLI, instala globalmente via npm e inicia o assistente de integração inicial.
Se você já tem o Node 22+ e prefere gerenciar a instalação por conta própria:
Para colaboradores ou qualquer pessoa que queira executar a partir de um checkout local.

Outros métodos de instalação

Docker

Implantações conteinerizadas ou headless.

Podman

Container rootless: execute setup-podman.sh uma vez e depois o script de inicialização.

Nix

Instalação declarativa via Nix.

Ansible

Provisionamento automatizado de frotas.

Bun

Uso somente da CLI via o runtime Bun.

Após a instalação

Verifique se tudo está funcionando:
Se você precisar de caminhos de runtime personalizados, use:
  • OPENCLAW_HOME para caminhos internos baseados no diretório home
  • OPENCLAW_STATE_DIR para o local de estado mutável
  • OPENCLAW_CONFIG_PATH para o local do arquivo de configuração
Veja Environment vars para a precedência e todos os detalhes.

Solução de problemas: openclaw não encontrado

Diagnóstico rápido:
Se $(npm prefix -g)/bin (macOS/Linux) ou $(npm prefix -g) (Windows) não estiver no seu $PATH, seu shell não consegue encontrar binários globais do npm (incluindo openclaw).Correção — adicione-o ao arquivo de inicialização do seu shell (~/.zshrc ou ~/.bashrc):
No Windows, adicione a saída de npm prefix -g ao seu PATH.Em seguida, abra um novo terminal (ou rehash no zsh / hash -r no bash).

Atualizar / desinstalar

Updating

Mantenha o OpenClaw atualizado.

Migrating

Mude para uma nova máquina.

Uninstall

Remova o OpenClaw completamente.