Skip to main content

​
Requisitos do sistema

  • Node 22.22.3+, 24.15+ ou 25.9+ - O Node 24 é o destino padrão; o script de instalação cuida disso automaticamente.
  • macOS, Linux ou Windows - Usuários do Windows podem começar com o aplicativo nativo Windows Hub, o instalador da CLI para PowerShell ou um Gateway no WSL2. Consulte Windows.
  • pnpm só é necessário para compilar a partir do código-fonte.

​
Recomendado: script de instalação

A maneira mais rápida de instalar. Ele detecta o sistema operacional, instala o Node se necessário, instala o OpenClaw e inicia a configuração inicial.
Usuários do Windows para desktop também podem instalar o aplicativo complementar nativo Windows Hub, que inclui configuração, status na bandeja, chat, modo Node e modo MCP local.
Para instalar sem executar a configuração inicial:
Para conhecer todas as opções e alternativas para CI/automação, consulte Detalhes internos do instalador.

​
Métodos alternativos de instalação

​
Instalador com prefixo local (install-cli.sh)

Use esta opção quando quiser manter o OpenClaw e o Node em um prefixo local, como ~/.openclaw, sem depender de uma instalação do Node disponível em todo o sistema:
Por padrão, ele oferece suporte a instalações via npm, além de instalações por checkout do git no mesmo fluxo de prefixo. Referência completa: Detalhes internos do instalador. Já está instalado? Alterne entre instalações por pacote e por git com openclaw update --channel dev e openclaw update --channel stable. Consulte Atualização.

​
npm, pnpm ou bun

Se você já gerencia o Node por conta própria:
O instalador hospedado limpa filtros de atualização do npm, como min-release-age, para a instalação do pacote OpenClaw. Se você fizer a instalação manualmente com o npm, sua própria política do npm continuará sendo aplicada.

​
A partir do código-fonte

Para colaboradores ou qualquer pessoa que queira executar a partir de um checkout local:
Também é possível ignorar o link e usar pnpm openclaw ... dentro do repositório. Consulte Configuração para ver os fluxos de trabalho completos de desenvolvimento.

​
Instalação a partir do checkout da branch main no GitHub

​
Contêineres e gerenciadores de pacotes

Docker

Implantações em contêiner ou sem interface gráfica.

Podman

Alternativa ao Docker para contêineres sem privilégios de root.

Nix

Instalação declarativa por meio de um flake do Nix.

Ansible

Provisionamento automatizado de frotas.

Bun

Instalador de dependências e executor de scripts de pacote opcional.

​
Verificar a instalação

Se quiser uma inicialização gerenciada após a instalação:
  • macOS: LaunchAgent por meio de openclaw onboard --install-daemon ou openclaw gateway install
  • Linux/WSL2: serviço de usuário do systemd por meio dos mesmos comandos
  • Windows nativo: primeiro uma Tarefa Agendada, com um item de login na pasta Inicializar por usuário como alternativa caso a criação da tarefa seja negada

​
Hospedagem e implantação

Implante o OpenClaw em um servidor de nuvem ou VPS. Consulte Servidor Linux para ver o seletor completo de provedores (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi e outros) ou faça a implantação de forma declarativa no Render.

VPS

Escolha um provedor.

VM com Docker

Etapas compartilhadas do Docker.

Kubernetes

Implantação no K8s.

​
Atualizar, migrar ou desinstalar

Atualização

Mantenha o OpenClaw atualizado.

Migração

Migre para uma nova máquina.

Desinstalação

Remova completamente o OpenClaw.

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

Quase sempre é um problema de PATH: o diretório global de binários do npm não está no PATH do shell. Consulte Solução de problemas do Node.js para ver a correção completa, incluindo o caminho no Windows.