Instalar

Requisitos do sistema

• Node 24 (recomendado) ou Node 22.19+ - o script de instalação cuida disso automaticamente
• macOS, Linux ou Windows - usuários do Windows podem começar com o app Windows Hub nativo, o instalador CLI do PowerShell ou um Gateway WSL2. Consulte Windows.
• pnpm só é necessário se você compilar a partir do código-fonte

Recomendado: script de instalação

A forma mais rápida de instalar. Ele detecta seu sistema operacional, instala o Node se necessário, instala o OpenClaw e inicia a integração inicial.

curl -fsSL https://openclaw.ai/install.sh | bash

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

Para instalar sem executar a integração inicial:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

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

Para todas as flags e opções de CI/automação, consulte Internos do instalador.

Métodos alternativos de instalação

Instalador de prefixo local (install-cli.sh)

Use isto quando quiser manter o OpenClaw e o Node em um prefixo local, como ~/.openclaw, sem depender de uma instalação de Node em todo o sistema:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

Ele oferece suporte a instalações npm por padrão, além de instalações por checkout do git no mesmo fluxo de prefixo. Referência completa: Internos do instalador.

Já instalado? Alterne entre instalações por pacote e por git com openclaw update --channel dev e openclaw update --channel stable. Consulte Atualização.

npm, pnpm ou bun

Se você já gerencia o Node por conta própria:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

A partir do código-fonte

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

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Ou pule o link e use pnpm openclaw ... de dentro do repositório. Consulte Configuração para fluxos de trabalho de desenvolvimento completos.

Instalar a partir do checkout main do GitHub

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

Contêineres e gerenciadores de pacotes

Verificar a instalação

openclaw --version      # confirme que a CLI está disponívelopenclaw doctor         # verifique problemas de configuraçãoopenclaw gateway status # verifique se o Gateway está em execução

Se você quiser inicialização gerenciada após a instalação:

• macOS: LaunchAgent via openclaw onboard --install-daemon ou openclaw gateway install
• Linux/WSL2: serviço de usuário systemd via os mesmos comandos
• Windows nativo: Scheduled Task primeiro, com fallback para item de login na pasta Startup por usuário se a criação da tarefa for negada

Hospedagem e implantação

Implante o OpenClaw em um servidor na nuvem ou VPS:

Atualizar, migrar ou desinstalar

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

Se a instalação foi concluída, mas openclaw não é encontrado no seu terminal:

node -v           # Node instalado?npm prefix -g     # Onde estão os pacotes globais?echo "$PATH"      # O diretório bin global está no PATH?

Se $(npm prefix -g)/bin não estiver no seu $PATH, adicione-o ao arquivo de inicialização do seu shell (~/.zshrc ou ~/.bashrc):

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

Depois, abra um novo terminal. Consulte Configuração do Node para mais detalhes.