Detalhes internos do instalador

Detectar SO

Compatível com macOS e Linux (incluindo WSL).

Garantir Node.js 24 por padrão

Verifica a versão do Node e instala Node 24 se necessário (Homebrew no macOS, scripts de configuração do NodeSource no Linux apt/dnf/yum). No macOS, o Homebrew é instalado somente quando o instalador precisa dele para Node ou Git. OpenClaw ainda oferece suporte ao Node 22 LTS, atualmente 22.19+, para compatibilidade. No Alpine/musl Linux, o instalador usa pacotes apk em vez de NodeSource; os repositórios Alpine configurados devem fornecer Node 22.19+ (Alpine 3.21 ou mais recente no momento da escrita).

Garantir Git

Instala Git se estiver ausente usando o gerenciador de pacotes detectado, incluindo Homebrew no macOS e apk no Alpine.

Instalar OpenClaw

• método npm (padrão): instalação global com npm
• método git: clona/atualiza o repositório, instala dependências com pnpm, compila e então instala o wrapper em ~/.local/bin/openclaw

Tarefas pós-instalação

• Atualiza um serviço gateway carregado em modo melhor esforço (openclaw gateway install --force, depois reinicia)
• Executa openclaw doctor --non-interactive em upgrades e instalações git (melhor esforço)
• Tenta onboarding quando apropriado (TTY disponível, onboarding não desativado, e verificações de bootstrap/config passam)

Instalar runtime Node local

Baixa um tarball Node LTS compatível fixado (a versão é incorporada no script e atualizada independentemente) para <prefix>/tools/node-v<version> e verifica SHA-256. No Alpine/musl Linux, onde Node não publica tarballs compatíveis para o runtime fixado, instala nodejs e npm com apk e vincula esse runtime ao caminho do wrapper no prefixo. Os repositórios Alpine devem fornecer Node 22.19+; use Alpine 3.21 ou mais recente se repositórios mais antigos fornecerem apenas Node 20 ou 21.

Garantir Git

Se Git estiver ausente, tenta instalar via apt/dnf/yum/apk no Linux ou Homebrew no macOS.

Instalar OpenClaw sob o prefixo

• método npm (padrão): instala sob o prefixo com npm, depois grava o wrapper em <prefix>/bin/openclaw
• método git: clona/atualiza um checkout (padrão ~/openclaw) e ainda grava o wrapper em <prefix>/bin/openclaw

Atualizar serviço gateway carregado

Se um serviço gateway já estiver carregado a partir desse mesmo prefixo, o script executa openclaw gateway install --force, depois openclaw gateway restart, e testa a integridade do gateway em modo melhor esforço.

Ensure PowerShell + Windows environment

Requer PowerShell 5+.

Ensure Node.js 24 by default

Se estiver ausente, tenta instalar via winget, depois Chocolatey e depois Scoop. Se nenhum gerenciador de pacotes estiver disponível, o script baixa o zip oficial do Node.js para Windows em %LOCALAPPDATA%\OpenClaw\deps\portable-node e o adiciona ao PATH do processo atual e do usuário. O Node 22 LTS, atualmente 22.19+, continua compatível.

Install OpenClaw

• Método npm (padrão): instalação global do npm usando o -Tag selecionado, iniciada a partir de um diretório temporário gravável do instalador para que shells abertos em pastas protegidas, como C:\, ainda funcionem
• Método git: clona/atualiza o repositório, instala/compila com pnpm e instala o wrapper em %USERPROFILE%\.local\bin\openclaw.cmd. Se o Git estiver ausente, o script inicializa um MinGit local do usuário em %LOCALAPPDATA%\OpenClaw\deps\portable-git e o adiciona ao PATH do processo atual e do usuário.

Post-install tasks

• Adiciona o diretório bin necessário ao PATH do usuário quando possível
• Atualiza um serviço Gateway carregado em modo de melhor esforço (openclaw gateway install --force, depois reinicia)
• Executa openclaw doctor --non-interactive em atualizações e instalações via git (melhor esforço)

Handle failures

Instalações com iwr ... | iex e scriptblock relatam um erro terminativo sem fechar a sessão atual do PowerShell. Instalações diretas com powershell -File / pwsh -File ainda saem com código diferente de zero para automação.