Saltar para o conteúdo principal

​
Instalação

Já seguiu Primeiros passos? Então está tudo pronto — esta página é para métodos alternativos de instalação, instruções específicas por plataforma e manutenção.

​
Requisitos do sistema

  • Node 22+ (o script de instalação irá instalá-lo se estiver ausente)
  • macOS, Linux ou Windows
  • pnpm apenas se você compilar a partir do código-fonte
No Windows, recomendamos fortemente executar o OpenClaw no WSL2.

​
Métodos de instalação

O script de instalação é a forma recomendada de instalar o OpenClaw. Ele cuida da detecção do Node, da instalação e da integração inicial em uma única etapa.

Installer script

Baixa a CLI, instala globalmente via npm e inicia o assistente de integração inicial.
```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  
</Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  
</Tab>

</Tabs>

É isso — o script cuida da detecção do Node, da instalação e da integração inicial.

Para pular a integração inicial e apenas instalar o binário:

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  
</Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  
</Tab>

</Tabs>

Para todas as flags, variáveis de ambiente e opções de CI/automação, consulte [Detalhes internos do instalador](/install/installer).
```
Se você já tem o Node 22+ e prefere gerenciar a instalação por conta própria:
```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="erros de build do sharp?">
      Se você tiver o libvips instalado globalmente (comum no macOS via Homebrew) e `sharp` falhar, force binários pré-compilados:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      Se você vir `sharp: Please add node-gyp to your dependencies`, instale as ferramentas de build (macOS: Xcode CLT + `npm install -g node-gyp`) ou use a variável de ambiente acima.
    
</Accordion>
  
</Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    <Note>
    O pnpm exige aprovação explícita para pacotes com scripts de build. Depois que a primeira instalação mostrar o aviso "Ignored build scripts", execute `pnpm approve-builds -g` e selecione os pacotes listados.
    
</Note>
  
</Tab>

</Tabs>
```
Para colaboradores ou qualquer pessoa que queira executar a partir de um checkout local.
```
<Steps>
  <Step title="Clonar e compilar">
    Clone o [repositório do OpenClaw](https://github.com/openclaw/openclaw) e compile:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```
  
</Step>
  <Step title="Vincular a CLI">
    Torne o comando `openclaw` disponível globalmente:

    ```bash
    pnpm link --global
    ```

    Como alternativa, pule o vínculo e execute os comandos via `pnpm openclaw ...` de dentro do repositório.
  
</Step>
  <Step title="Executar a integração inicial">
    ```bash
    openclaw onboard --install-daemon
    ```
  
</Step>

</Steps>

Para fluxos de desenvolvimento mais avançados, consulte [Configuração](/start/setup).
```

​
Outros métodos de instalação

Docker

Implantações conteinerizadas ou headless.

Podman

Container rootless: execute setup-podman.sh uma vez e depois o script de inicialização.

Nix

Instalação declarativa via Nix.

Ansible

Provisionamento automatizado de frotas.

Bun

Uso somente da CLI via o runtime Bun.

​
Após a instalação

Verifique se tudo está funcionando: 
openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI
Se você precisar de caminhos de runtime personalizados, use:
  • OPENCLAW_HOME para caminhos internos baseados no diretório home
  • OPENCLAW_STATE_DIR para o local de estado mutável
  • OPENCLAW_CONFIG_PATH para o local do arquivo de configuração
Veja Environment vars para a precedência e todos os detalhes.

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

Diagnóstico rápido:
node -v
npm -v
npm prefix -g
echo "$PATH"
Se $(npm prefix -g)/bin (macOS/Linux) ou $(npm prefix -g) (Windows) não estiver no seu $PATH, seu shell não consegue encontrar binários globais do npm (incluindo openclaw).Correção — adicione-o ao arquivo de inicialização do seu shell (~/.zshrc ou ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"
No Windows, adicione a saída de npm prefix -g ao seu PATH.Em seguida, abra um novo terminal (ou rehash no zsh / hash -r no bash).

​
Atualizar / desinstalar

Updating

Mantenha o OpenClaw atualizado.

Migrating

Mude para uma nova máquina.

Uninstall

Remova o OpenClaw completamente.