Node.js

O OpenClaw requer Node 22.16 ou mais recente. Node 24 e o runtime padrao e recomendado para instalacoes, CI e workflows de release. O Node 22 continua suportado pela linha LTS ativa. O script de instalacao vai detectar e instalar o Node automaticamente — esta pagina e para quando voce quer configurar o Node por conta propria e garantir que tudo esta funcionando corretamente (versoes, PATH, instalacoes globais).

Verifique sua versao

node -v

Se isso mostra v24.x.x ou superior, voce esta na versao padrao recomendada. Se mostra v22.16.x ou superior, voce esta no caminho suportado do Node 22 LTS, mas ainda recomendamos atualizar para o Node 24 quando conveniente. Se o Node nao esta instalado ou a versao e muito antiga, escolha um metodo de instalacao abaixo.

Instalar o Node

macOS

**Homebrew** (recomendado):

```bash
brew install node
```

Ou baixe o instalador macOS de [nodejs.org](https://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 versoes (veja abaixo).

Windows

**winget** (recomendado):

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

Ou baixe o instalador Windows de [nodejs.org](https://nodejs.org/).

Usando um gerenciador de versoes (nvm, fnm, mise, asdf)

Gerenciadores de versoes permitem trocar facilmente entre versoes do Node. Opcoes populares:

fnm — rapido, multiplataforma
nvm — amplamente usado no macOS/Linux
mise — poliglota (Node, Python, Ruby, etc.)

Exemplo com fnm:

fnm install 24
fnm use 24

Aviso: Certifique-se de que seu gerenciador de versoes esta inicializado no arquivo de inicializacao do shell (~/.zshrc ou ~/.bashrc). Se nao estiver, openclaw pode nao ser encontrado em novas sessoes de terminal porque o PATH nao incluira o diretorio bin do Node.

Solucao de problemas

`openclaw: command not found`

Isso quase sempre significa que o diretorio bin global do npm nao esta no seu PATH.

Passo 1: Encontre seu prefixo npm global

```bash
npm prefix -g
```

Passo 2: Verifique se esta no seu PATH

```bash
echo "$PATH"
```

Procure por `<npm-prefix>/bin` (macOS/Linux) ou `<npm-prefix>` (Windows) na saida.

Passo 3: Adicione ao arquivo de inicializacao do shell

  #### macOS / Linux
    Adicione ao `~/.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 saida de `npm prefix -g` ao PATH do sistema via Configuracoes → Sistema → Variaveis de Ambiente.

Erros de permissao no `npm install -g` (Linux)

Se voce ver erros EACCES, mude o prefixo global do npm para um diretorio gravavel pelo usuario:

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 permanente.