OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

O OpenClaw requer Node 22.22.3+, Node 24.15+ ou Node 25.9+. O Node 24 é o runtime padrão e recomendado para instalações, CI e fluxos de trabalho de lançamento; o Node 22 continua sendo compatível por meio da linha LTS ativa. O Node 23 não é compatível. O script de instalação detecta e instala o Node automaticamente — use esta página quando quiser configurar o Node por conta própria (versões, PATH, instalações globais).

Verifique sua versão

bash
node -v

v24.15.0 ou uma versão 24.x mais recente é o padrão recomendado. v22.22.3 ou uma versão 22.x mais recente é o caminho compatível do Node 22 LTS; o Node v25.9.0+ também é compatível. O Node 23 não é compatível. Se o Node estiver ausente ou fora do intervalo compatível, escolha um método de instalação abaixo.

Instale o Node

macOS

Homebrew (recomendado):

bash
brew install node

Ou baixe o instalador para macOS em nodejs.org.

Linux

Ubuntu / Debian:

bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejs

Fedora / RHEL:

bash
sudo dnf install nodejs

Ou use um gerenciador de versões (veja abaixo).

Windows

winget (recomendado):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

Ou baixe o instalador para Windows em nodejs.org.

Como usar um gerenciador de versões (nvm, fnm, mise, asdf)

Os gerenciadores de versões permitem alternar facilmente entre versões do Node. Opções populares:

  • fnm - rápido e multiplataforma
  • nvm - amplamente usado no macOS/Linux
  • mise - poliglota (Node, Python, Ruby etc.)

Exemplo com fnm:

bash
fnm install 24fnm use 24

Solução de problemas

openclaw: command not found

Isso quase sempre significa que o diretório bin global do npm não está no seu PATH.

  • Encontre o prefixo global do npm

    bash
    npm prefix -g

  • Verifique se ele está no seu PATH

    bash
    echo "$PATH"

    Procure por <npm-prefix>/bin (macOS/Linux) ou <npm-prefix> (Windows) na saída.

  • Adicione-o ao arquivo de inicialização do shell

    macOS / Linux

    Adicione a ~/.zshrc ou ~/.bashrc:

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

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

    Windows

    Adicione a saída de npm prefix -g ao PATH do sistema em Settings → System → Environment Variables.

    • Erros de permissão em npm install -g (Linux)

    Se você encontrar erros EACCES, altere o prefixo global do npm para um diretório no qual o usuário possa gravar:

    bash
    mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"

    Adicione a linha export PATH=... ao seu ~/.bashrc ou ~/.zshrc para tornar a alteração permanente.

    Conteúdo relacionado

    Was this useful?
    On this page

    On this page