Install overview
Node.js
OpenClaw には Node 22.22.3+、Node 24.15+、または Node 25.9+ が必要です。インストール、CI、リリースワークフローでは、Node 24 がデフォルトかつ推奨のランタイムです。Node 22 はアクティブな LTS 系列を通じて引き続きサポートされます。Node 23 はサポートされていません。インストーラースクリプトは Node を自動的に検出してインストールします。このページは、バージョン、PATH、グローバルインストールなど、Node を自分でセットアップする場合に使用してください。
バージョンを確認する
node -vv24.15.0 以降の 24.x が推奨デフォルトです。v22.22.3 以降の 22.x は、サポートされる Node 22 LTS の選択肢です。Node v25.9.0+ もサポートされています。Node 23 はサポートされていません。Node がインストールされていない場合や、サポート対象範囲外の場合は、以下のインストール方法を選択してください。
Node をインストールする
macOS
Homebrew（推奨）:
brew install nodeまたは、nodejs.org から macOS 用インストーラーをダウンロードします。
Linux
Ubuntu / Debian:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejsFedora / RHEL:
sudo dnf install nodejsまたは、バージョンマネージャーを使用します（以下を参照）。
Windows
winget（推奨）:
winget install OpenJS.NodeJS.LTSChocolatey:
choco install nodejs-ltsまたは、nodejs.org から Windows 用インストーラーをダウンロードします。
バージョンマネージャーを使用する（nvm、fnm、mise、asdf）
バージョンマネージャーを使用すると、Node のバージョンを簡単に切り替えられます。一般的な選択肢は次のとおりです。
fnm の例:
fnm install 24fnm use 24トラブルシューティング
openclaw: command not found
ほとんどの場合、npm のグローバル bin ディレクトリが PATH に含まれていないことを意味します。
グローバル npm プレフィックスを確認する
npm prefix -gPATH に含まれているか確認する
echo "$PATH"出力に <npm-prefix>/bin（macOS/Linux）または <npm-prefix>（Windows）が含まれているか確認します。
シェルの起動ファイルに追加する
macOS / Linux
~/.zshrc または ~/.bashrc に追加します。
export PATH="$(npm prefix -g)/bin:$PATH"その後、新しいターミナルを開きます（または、zsh では rehash、bash では hash -r を実行します）。
Windows
npm prefix -g の出力を、Settings → System → Environment Variables からシステムの 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 に追加します。
