Instalar

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.

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

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

Para instalar sem executar a configuração inicial:

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

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

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:

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

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:

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

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

A partir do código-fonte

Para colaboradores ou qualquer pessoa que queira executar a partir de um checkout local:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

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

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Contêineres e gerenciadores de pacotes

Verificar a instalação

openclaw --version      # confirme se a CLI está disponívelopenclaw doctor         # verifique se há problemas de configuraçãoopenclaw gateway status # verifique se o Gateway está em execuçã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.

Atualizar, migrar ou desinstalar

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.

node -v           # o Node está instalado?npm prefix -g     # onde ficam os pacotes globais?echo "$PATH"      # o diretório global de binários está no PATH?