English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

OpenClaw requer Node 22.14 ou mais recente. Node 24 é o ambiente de execução padrão e recomendado para instalações, CI e fluxos de lançamento. Node 22 continua compatível por meio da linha LTS ativa. O script de instalação detectará e instalará o Node automaticamente - esta página é para quando você quiser configurar o Node por conta própria e garantir que tudo esteja conectado corretamente (versões, PATH, instalações globais).

Verifique sua versão

node -v

Se isso imprimir v24.x.x ou superior, você está no padrão recomendado. Se imprimir v22.14.x ou superior, você está no caminho compatível do Node 22 LTS, mas ainda recomendamos atualizar para o Node 24 quando for conveniente. Se o Node não estiver instalado ou a versão for antiga demais, escolha um método de instalação abaixo.

Instale o Node

macOS

Homebrew (recomendado):

brew install node

Ou baixe o instalador para macOS em nodejs.org.

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

sudo dnf install nodejs

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

Windows

winget (recomendado):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Ou baixe o instalador para Windows em nodejs.org.

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

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

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

Exemplo com fnm:

fnm install 24
fnm 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 seu prefixo global do npm

    npm prefix -g

  • Verifique se ele está no seu PATH

    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:

    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 via Configurações → Sistema → Variáveis de Ambiente.

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

    Se você vir erros EACCES, altere o prefixo global do npm para um diretório gravável pelo usuário:

    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 torná-la permanente.

    Relacionados