Detalhes internos do instalador

Detectar o sistema operacional

Oferece suporte ao macOS e ao Linux (incluindo WSL).

Garantir o Node.js 24 por padrão

Verifica a versão do Node e instala o Node 24 se necessário (Homebrew no macOS, scripts de configuração do NodeSource no apt/dnf/yum do Linux). No macOS, o Homebrew é instalado somente quando o instalador precisa dele para o Node ou o Git. O Node 22.19+ e o 23.11+ continuam sendo compatíveis. No Alpine/Linux musl, o instalador usa pacotes apk em vez do NodeSource; os repositórios Alpine configurados devem fornecer uma versão compatível do Node (Alpine 3.21 ou mais recente no momento da redação).

Garantir o Git

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

Instalar o OpenClaw

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

Tarefas pós-instalação

• Localiza o binário openclaw recém-instalado para os comandos subsequentes
• Em uma instalação não configurada, inicia a integração inicial antes das verificações do doctor ou do Gateway. Com --no-onboard ou sem TTY, exibe o comando para concluir a configuração posteriormente.
• Em uma instalação configurada, atualiza e reinicia, na medida do possível, um serviço Gateway carregado e executa o doctor. As atualizações atualizam os plugins quando possível ou exibem o comando manual em uma execução sem interface com prompts habilitados.
• Quando --verify é executado, verifica a versão instalada e a integridade do Gateway somente após existir uma configuração.

Instalar o runtime local do Node

Baixa um tarball fixado de uma versão LTS compatível do Node (a versão é incorporada ao script e atualizada de forma independente; o padrão é 22.22.2) para <prefix>/tools/node-v<version> e verifica o SHA-256. No Alpine/Linux musl, para o qual o Node não publica tarballs compatíveis com 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 uma versão compatível do Node (22.19+, 23.11+ ou 24+); use o Alpine 3.21 ou mais recente se os repositórios antigos fornecerem apenas o Node 20 ou 21.

Garantir o Git

Se o Git estiver ausente, tenta instalá-lo via apt/dnf/yum/apk no Linux ou Homebrew no macOS.

Instalar o OpenClaw no prefixo

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

Atualizar o serviço Gateway carregado

Se um serviço Gateway já estiver carregado a partir desse mesmo prefixo, o script executará openclaw gateway install --force, depois openclaw gateway restart e verificará a integridade do Gateway na medida do possível.

Garantir o ambiente PowerShell + Windows

Requer PowerShell 5 ou posterior.

Garantir o Node.js 24 por padrão

Se estiver ausente, tenta instalá-lo via winget, depois Chocolatey e, por fim, Scoop. Se nenhum gerenciador de pacotes estiver disponível, o script baixa o arquivo zip oficial do Node.js 24 para Windows em %LOCALAPPDATA%\OpenClaw\deps\portable-node e o adiciona ao PATH do processo atual e do usuário. O Node 22.19 ou posterior e o 23.11 ou posterior continuam compatíveis.

Instalar o OpenClaw

• Método npm (padrão): instalação global via 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:\, continuem funcionando
• 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 o MinGit local do usuário em %LOCALAPPDATA%\OpenClaw\deps\portable-git e o adiciona ao PATH do processo atual e do usuário.

Executar tarefas pós-instalação

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

Tratar falhas

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