Node.js

OpenClaw には Node 22.16 以上が必要です。Node 24 がデフォルトかつ推奨のランタイムであり、インストール、CI、リリースワークフローで使用されます。Node 22 はアクティブな LTS ラインとして引き続きサポートされています。インストーラースクリプトが Node を自動的に検出・インストールします。このページは、Node を自分でセットアップし、すべてが正しく設定されている（バージョン、PATH、グローバルインストール）ことを確認したい場合向けです。

バージョンの確認

node -v

v24.x.x 以上が表示されれば、推奨のデフォルトを使用しています。v22.16.x 以上であれば、サポート対象の Node 22 LTS パスですが、都合の良いタイミングで Node 24 へのアップグレードを推奨します。Node がインストールされていないか、バージョンが古い場合は、以下のインストール方法から選択してください。

Node のインストール

macOS

**Homebrew**（推奨）：

```bash
brew install node
```

または [nodejs.org](https://nodejs.org/) から macOS インストーラーをダウンロードしてください。

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
```

またはバージョンマネージャーを使用してください（以下を参照）。

Windows

**winget**（推奨）：

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

**Chocolatey：**

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

または [nodejs.org](https://nodejs.org/) から Windows インストーラーをダウンロードしてください。

fnm install 24
fnm use 24

トラブルシューティング

openclaw: command not found

ほぼすべてのケースで、npm のグローバル bin ディレクトリが PATH に含まれていないことが原因です。

ステップ1：グローバル npm プレフィックスを確認

```bash
npm prefix -g
```

ステップ2：PATH に含まれているか確認

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

出力に `<npm-prefix>/bin`（macOS/Linux）または `<npm-prefix>`（Windows）が含まれているか確認してください。

ステップ3：シェルのスタートアップファイルに追加

  #### macOS / Linux
    `~/.zshrc` または `~/.bashrc` に追加：

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

    その後、新しいターミナルを開いてください（zsh では `rehash`、bash では `hash -r` でも可）。

  #### Windows
    `npm prefix -g` の出力を、設定 → システム → 環境変数でシステム PATH に追加してください。

npm install -g での権限エラー（Linux）

EACCES エラーが表示される場合は、npm のグローバルプレフィックスをユーザー書き込み可能なディレクトリに変更してください：

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

export PATH=... の行を ~/.bashrc または ~/.zshrc に追加して永続化してください。