Detalhes do instalador

O OpenClaw disponibiliza tres scripts de instalacao, servidos de openclaw.ai.

Script	Plataforma	O que faz
`install.sh`	macOS / Linux / WSL	Instala o Node se necessario, instala o OpenClaw via npm (padrao) ou git, e pode rodar o onboarding.
`install-cli.sh`	macOS / Linux / WSL	Instala Node + OpenClaw em um prefixo local (`~/.openclaw`). Nao requer root.
`install.ps1`	Windows (PowerShell)	Instala o Node se necessario, instala o OpenClaw via npm (padrao) ou git, e pode rodar o onboarding.

Comandos rapidos

install.sh

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help
```

install-cli.sh

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
```

install.ps1

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

Nota: Se a instalacao teve sucesso mas openclaw nao e encontrado em um novo terminal, veja Solucao de problemas Node.js.

install.sh

Dica: Recomendado para a maioria das instalacoes interativas em macOS/Linux/WSL.

Fluxo (install.sh)

Passo 1: Detectar SO

Suporta macOS e Linux (incluindo WSL). Se macOS for detectado, instala Homebrew se ausente.

Passo 2: Garantir Node.js 24 por padrao

Verifica a versao do Node e instala Node 24 se necessario. O OpenClaw ainda suporta Node 22 LTS, atualmente `22.16+`.

Passo 3: Garantir Git

Instala o Git se ausente.

Passo 4: Instalar OpenClaw

- Metodo `npm` (padrao): instalacao npm global
- Metodo `git`: clona/atualiza o repo, instala deps com pnpm, compila, depois instala wrapper em `~/.local/bin/openclaw`

Passo 5: Tarefas pos-instalacao

- Executa `openclaw doctor --non-interactive` em atualizacoes e instalacoes git (best effort)
- Tenta onboarding quando apropriado
- Define `SHARP_IGNORE_GLOBAL_LIBVIPS=1` por padrao

Exemplos (install.sh)

Padrao

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```

Pular onboarding

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard
```

Instalacao git

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

Simulacao

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run
```

Referencia de flags

Flag	Descricao
`--install-method npm\|git`	Metodo de instalacao (padrao: `npm`). Alias: `--method`
`--npm`	Atalho para metodo npm
`--git`	Atalho para metodo git. Alias: `--github`
`--version <version\|dist-tag>`	Versao npm ou dist-tag (padrao: `latest`)
`--beta`	Usar dist-tag beta se disponivel
`--git-dir <path>`	Diretorio de checkout (padrao: `~/openclaw`)
`--no-git-update`	Pular `git pull` para checkout existente
`--no-prompt`	Desabilitar prompts
`--no-onboard`	Pular onboarding
`--onboard`	Habilitar onboarding
`--dry-run`	Mostrar acoes sem aplicar
`--verbose`	Saida de debug
`--help`	Mostrar ajuda (`-h`)

Referencia de variaveis de ambiente

Variavel	Descricao
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metodo de instalacao
`OPENCLAW_VERSION=latest\|next\|<semver>`	Versao npm ou dist-tag
`OPENCLAW_BETA=0\|1`	Usar beta se disponivel
`OPENCLAW_GIT_DIR=<path>`	Diretorio de checkout
`OPENCLAW_NO_PROMPT=1`	Desabilitar prompts
`OPENCLAW_NO_ONBOARD=1`	Pular onboarding
`OPENCLAW_DRY_RUN=1`	Modo simulacao
`OPENCLAW_VERBOSE=1`	Modo debug

install-cli.sh

Info: Projetado para ambientes onde voce quer tudo sob um prefixo local (padrao ~/.openclaw) sem dependencia de Node do sistema.

Exemplos (install-cli.sh)

Padrao

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
```

Prefixo + versao personalizados

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest
```

Saida JSON para automacao

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw
```

install.ps1

Exemplos (install.ps1)

Padrao

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

Instalacao git

```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git
```

Simulacao

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

Nota: Se -InstallMethod git e usado e o Git esta ausente, o script encerra e mostra o link do Git for Windows.

CI e automacao

Use flags/variaveis nao-interativas para execucoes previsiveis.

install.sh (npm nao-interativo)

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard
```

install.ps1 (pular onboarding)

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

Solucao de problemas

Por que o Git e necessario?

Git e necessario para o metodo de instalacao `git`. Para instalacoes `npm`, o Git ainda e verificado/instalado para evitar falhas `spawn git ENOENT` quando dependencias usam URLs git.

Por que o npm mostra EACCES no Linux?

Algumas configuracoes Linux apontam o prefixo global npm para caminhos pertencentes ao root. `install.sh` pode mudar o prefixo para `~/.npm-global` e adicionar exports PATH aos arquivos rc do shell.

Problemas sharp/libvips

Os scripts definem `SHARP_IGNORE_GLOBAL_LIBVIPS=1` por padrao para evitar que sharp compile contra o libvips do sistema.

openclaw nao encontrado apos instalacao

Geralmente e um problema de PATH. Consulte [Solucao de problemas Node.js](/docs/install/node#troubleshooting).