Instalar

Requisitos do sistema

• Node 22.19+, 23.11+ ou 24+ — 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 pelo aplicativo nativo Windows Hub, pelo instalador da CLI para PowerShell ou por um Gateway no WSL2. Consulte Windows.
• pnpm só é necessário se você compilar a partir do código-fonte.

Recomendado: script de instalação

A maneira mais rápida de instalar. Ele detecta seu 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 ver 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 é compatível com 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

Como alternativa, ignore a vinculação e use pnpm openclaw ... dentro do repositório. Consulte Configuração para ver os fluxos completos de desenvolvimento.

Instalar a partir do checkout principal do 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 que a CLI está disponívelopenclaw doctor         # verifique se há problemas de configuraçãoopenclaw gateway status # verifique se o Gateway está em execução

Se você 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 uma implantação declarativa no Render.

Atualizar, migrar ou desinstalar

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

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

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