Instalacao

Ja seguiu o Primeiros Passos? Entao esta tudo pronto — esta pagina cobre metodos alternativos de instalacao, instrucoes especificas por plataforma e manutencao.

Requisitos do sistema

Node 24 (recomendado) (Node 22 LTS, atualmente 22.16+, ainda e suportado para compatibilidade; o script de instalacao instalara o Node 24 se estiver ausente)
macOS, Linux ou Windows
pnpm apenas se voce compilar a partir do codigo-fonte

Nota: No Windows, recomendamos fortemente executar o OpenClaw no WSL2.

Metodos de instalacao

Dica: O script de instalacao e a forma recomendada de instalar o OpenClaw. Ele cuida da deteccao do Node, instalacao e onboarding em uma unica etapa.

Aviso: Para VPS/hosts na nuvem, evite imagens de marketplace de terceiros “1-click” quando possivel. Prefira uma imagem de SO base limpa (por exemplo Ubuntu LTS), depois instale o OpenClaw manualmente com o script de instalacao.

Script de instalacao

Baixa o CLI, instala globalmente via npm e inicia o assistente de onboarding.


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



Pronto — o script cuida da deteccao do Node, instalacao e onboarding.

Para pular o onboarding e apenas instalar o binario:


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```

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



Para todas as flags, variaveis de ambiente e opcoes de CI/automacao, consulte [Detalhes do instalador](/docs/install/installer).

npm / pnpm

Se voce ja gerencia o Node por conta propria, recomendamos o Node 24. O OpenClaw ainda suporta Node 22 LTS, atualmente `22.16+`, para compatibilidade:


  #### npm
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <details>

Erros de build do sharp?

      Se voce tem o libvips instalado globalmente (comum no macOS via Homebrew) e o `sharp` falha, force os binarios pre-compilados:

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

      Se voce ver `sharp: Please add node-gyp to your dependencies`, instale as ferramentas de build (macOS: Xcode CLT + `npm install -g node-gyp`) ou use a variavel de ambiente acima.
    </details>

  #### pnpm
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # aprovar openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    > **Nota:** O pnpm requer aprovacao explicita para pacotes com scripts de build. Apos a primeira instalacao mostrar o aviso "Ignored build scripts", execute `pnpm approve-builds -g` e selecione os pacotes listados.

A partir do codigo-fonte

Para contribuidores ou qualquer pessoa que queira executar a partir de um checkout local.


  ### Passo 1: Clonar e compilar
    Clone o [repositorio 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
    ```

  ### Passo 2: Vincular o CLI
    Torne o comando `openclaw` disponivel globalmente:

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

    Como alternativa, pule o vinculo e execute comandos via `pnpm openclaw ...` de dentro do repositorio.

  ### Passo 3: Executar o onboarding
    ```bash
    openclaw onboard --install-daemon
    ```



Para workflows de desenvolvimento mais avancados, consulte [Configuracao](/docs/start/setup).

Outros metodos de instalacao

Docker — Implantacoes containerizadas ou headless.
Podman — Container rootless: execute setup-podman.sh uma vez, depois o script de inicializacao.
Nix — Instalacao declarativa via Nix.
Ansible — Provisionamento automatizado de frotas.
Bun — Uso somente CLI via o runtime Bun.

Apos a instalacao

Verifique se tudo esta funcionando:

openclaw doctor         # verificar problemas de configuracao
openclaw status         # status do gateway
openclaw dashboard      # abrir a interface web

Se voce precisa de caminhos de execucao personalizados, use:

OPENCLAW_HOME para caminhos internos baseados no diretorio home
OPENCLAW_STATE_DIR para localizacao do estado mutavel
OPENCLAW_CONFIG_PATH para localizacao do arquivo de configuracao

Consulte Variaveis de ambiente para precedencia e detalhes completos.

Solucao de problemas: `openclaw` nao encontrado

Diagnostico e correcao do PATH

Diagnostico rapido:

node -v
npm -v
npm prefix -g
echo "$PATH"

Se $(npm prefix -g)/bin (macOS/Linux) ou $(npm prefix -g) (Windows) nao esta no seu $PATH, seu shell nao consegue encontrar os binarios npm globais (incluindo openclaw).

Correcao — adicione ao seu arquivo de inicializacao do shell (~/.zshrc ou ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

No Windows, adicione a saida de npm prefix -g ao seu PATH.

Em seguida, abra um novo terminal (ou rehash no zsh / hash -r no bash).

Atualizacao / desinstalacao

Atualizacao — Mantenha o OpenClaw atualizado.
Migracao — Mude para uma nova maquina.
Desinstalacao — Remova o OpenClaw completamente.