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

Install overview

Node.js

OpenClaw requer Node 22.16 ou mais recente. Node 24 é o runtime padrão e recomendado para instalações, CI e fluxos de lançamento. Node 22 continua com suporte pela 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

bash
node -v

Se isso imprimir v24.x.x ou superior, você está no padrão recomendado. Se imprimir v22.16.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):

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.

Using a version manager (nvm, fnm, mise, asdf)

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

  • fnm - rápido, 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.

  • Find your global npm prefix

    bash
    npm prefix -g

  • Check if it's on your PATH

    bash
    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

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

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

    Depois 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:

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

    Relacionado

    Was this useful?