Como Instalar OpenClaw

Use o instalador oficial e finalize o assistente de integração para a configuração mais rápida e segura.

Resposta curta

Confirm system requirements (Node.js 22+, macOS or Linux or Windows via WSL2), run the official install script, then complete openclaw onboard to connect channels and models.

Etapa 1: Verifique os requisitos primeiro

OpenClaw depende de recursos modernos do Node, portanto, o Node.js 22 ou posterior é necessário. No Windows, o caminho suportado é WSL2. A instalação em versões mais antigas do Node é a causa mais comum de falhas.

Etapa 2: Use o script de instalação oficial

O método recomendado instala a CLI e prepara o ambiente de execução:

curl -fsSL https://openclaw.bot/install.sh | bash
openclaw onboard --install-daemon

Etapa 3: Conclua a integração

O assistente guia você pelo emparelhamento de um canal de mensagens, seleção de um provedor de modelo e ativação de habilidades. É aqui que você define permissões iniciais e confirma o que OpenClaw pode acessar.

Comandos úteis após a instalação

Use openclaw doctor to validate dependencies, openclaw status or openclaw health to check the gateway, and openclaw update to stay current.

Verifique a instalação antes do uso em produção

Após a integração, execute uma pequena tarefa de teste que use uma habilidade de baixo risco, como criar um arquivo em uma pasta temporária ou resumir um arquivo de texto local. Isso confirma que seu canal, modelo e habilidades estão corretamente conectados. Se você estiver implantando em um servidor, verifique se apenas as portas necessárias estão abertas e se o emparelhamento administrativo é aplicado.

Armadilhas comuns de instalação

Most failures come from an outdated Node version, missing build tools, or running the script under the wrong user account. Another frequent issue is partial installs caused by network errors during package download. If the CLI behaves inconsistently, re-run the install script and check logs with openclaw doctor .

Lembretes de segurança

Não exponha endpoints administrativos à internet pública e evite instalar habilidades não confiáveis. Se você executar OpenClaw em um servidor, restrinja as portas e use o acesso com privilégio mínimo.

Referências oficiais

For exact instructions, see the official install and wizard pages: Install and Onboard .